Coding¶

In one paragraph¶

Coding wraps whichever AI coding assistant you use — Claude Code, Copilot CLI, OpenCode or Pi — in a shared environment that records every session, extracts durable knowledge from that history, blocks known mistakes at the moment a tool is called, and reports what it all cost. The assistant is replaceable; the environment around it is the point.

Install and run¶

git clone --recurse-submodules https://github.com/fwornle/coding ~/Agentic/coding
cd ~/Agentic/coding && ./install.sh
source ~/.zshrc          # or ~/.bashrc
coding                   # launches Claude Code with everything wired up

What you get¶

Where to go next¶

coding --health should come back all green. If it does, read Getting Started; if it does not, go straight to Verify & Repair.

What the layer actually does¶

Coding is infrastructure that sits around an AI coding assistant rather than inside it. It does four things, and they compound: it captures every session, learns from the accumulated history, prevents repeats of known mistakes, and measures what the work costs.

Capture, learn, prevent¶

Live Session Logging records every conversation automatically into .coding/history/, classifying content so that work touching several projects is routed to the right one, and redacting secrets on the way through. Nothing is asked of you.

Knowledge Management turns that history, plus your git log, into a knowledge graph via a 14-agent extraction pass:

semantic workflow run wave-analysis --team coding   # the extraction pass, async, 10-20 min
semantic workflow status                            # how far it has got
vkb                                                 # browse the result at :8080

Constraints run as PreToolUse hooks, so a violating call is stopped before execution rather than reported afterwards. Twenty-odd rules ship configured; the dashboard at localhost:3030 shows what fired and why.

Health monitoring supervises the services in layers, restarting what dies, and surfaces the result both at localhost:3032 and in the tmux status bar.

Any agent, one environment¶

Claude Code is the default, but nothing above is specific to it:

All four share the same tmux wrapping, status line, health monitoring, session logging, knowledge base and constraint enforcement. Adding a fifth is a single config file in config/agents/ — see the Agent Integration Guide.

Always launch through coding. A bare claude session still works, but it is invisible to token accounting because the adapters that capture it are installed per launch.

Everyday commands¶

What is production-ready¶

Session logging, the knowledge base and viewer, constraints, health monitoring and the status line are all in production use. Online learning — continuous knowledge capture without an explicit pass — is still beta.

A self-learning experience layer for AI coding assistants

Coding wraps around your AI coding assistant to capture conversations, build knowledge, prevent mistakes, and track progress - creating a continuously improving development environment.

What is Coding?¶

Coding is an infrastructure layer that enhances AI coding assistants by:

• Capturing everything - Automatic session logging of all prompts, tool calls, and responses
• Learning from experience - Build a knowledge base from your coding history and conversations
• Preventing mistakes - Constraint system stops errors before they happen

Key Features¶

Live Session Logging (LSL)¶

Every conversation is captured automatically with intelligent 5-layer classification that routes content between projects.

• Real-time monitoring with zero data loss
• Automatic redaction of secrets and credentials
• Multi-project support with foreign session tracking
• Configurable time-based slots (hourly files)

Learn more about LSL

Knowledge Management (UKB/VKB)¶

A 14-agent AI system extracts insights from your git history and conversation logs, building a searchable knowledge graph.

Update Knowledge Base (UKB):

semantic workflow run wave-analysis --team coding           # production pass
semantic workflow run wave-analysis --team coding --debug   # mock LLM, single-step
semantic workflow status                                    # progress of the current run

The pass is asynchronous — the command returns a workflow id and leaves the run going, so watch it on the dashboard or poll semantic workflow status rather than waiting on it.

View Knowledge Base (VKB):

vkb           # Opens http://127.0.0.1:12436/viewer/coding

Learn more about Knowledge Management

Constraint System¶

20+ configurable constraints enforce code quality via PreToolUse hooks - preventing mistakes before they happen.

• Real-time violation detection and blocking
• Web dashboard for monitoring and configuration
• Per-project constraint configuration
• Auto-correction suggestions

Learn more about Constraints

Health Monitoring¶

3-layer supervision architecture ensures system reliability with automatic recovery.

• Process health monitoring with automatic restart
• Service lifecycle management
• Multi-agent workflow visualization
• LLM call tracing (tokens, duration, costs)

Learn more about Health Monitoring

Status Line¶

Real-time feedback via the unified tmux status bar showing system health, costs, and development state. All coding agents (Claude, Copilot, OpenCode, Pi) are wrapped in tmux sessions with a shared status line rendered by combined-status-line.js.

Learn more about Status Line

Multi-Agent Support¶

While Claude Code is the primary and default agent, coding is fully agent-agnostic. Any coding assistant can be integrated with a single config file — no changes to shared code needed.

All agents share the same infrastructure: tmux session wrapping, status line, health monitoring, LSL session logging, knowledge management, and constraint enforcement. Missing agent CLIs are auto-installed on first launch.

Agent Integration Guide

Quick Start¶

# Clone and install
git clone --recurse-submodules https://github.com/fwornle/coding ~/Agentic/coding
cd ~/Agentic/coding && ./install.sh

# Reload shell
source ~/.bashrc  # or ~/.zshrc

# Start coding with all features
coding

# View your knowledge graph
vkb

Full Installation Guide

Design Principles¶

Feature Status¶

MCP Integrations¶

Coding provides several MCP (Model Context Protocol) servers:

Documentation¶