Getting Started¶

Get coding running in under 5 minutes.

Installation¶

Coding runs in Docker. All services (MCP servers, databases, dashboards) run as containers; only the Claude/Copilot CLI runs natively on the host and connects via lightweight stdio proxies.

Benefits:

• Isolated services in containers
• Persistent state survives restarts
• Consistent behavior across machines
• Easy cleanup (just stop containers)

Install with Docker

Prerequisites¶

Quick Install¶

brew install git node jq tmux
brew install --cask docker

sudo apt update && sudo apt install -y git nodejs npm jq tmux
curl -fsSL https://get.docker.com | sh

sudo apt update && sudo apt install -y git nodejs npm jq tmux

Quick Start¶

# 1. Clone repository with submodules
git clone --recurse-submodules https://github.com/fwornle/coding ~/Agentic/coding
cd ~/Agentic/coding

# 2. Run installer
./install.sh

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

# 4. Start coding
coding

That's it! The installer handles everything automatically.

What Gets Installed¶

Installation Safety¶

The installer follows a non-intrusive policy:

• Prompts before any system-level changes
• Creates timestamped backups of shell config
• Supports --skip-all to decline all system changes
• All data stays in ~/Agentic/coding/

Verification¶

After installation, verify everything is working:

coding --health

All services should show green. If you see issues, run:

./scripts/test-coding.sh --interactive

Full Verification Guide

First Usage¶

Start a Session¶

# Launch Claude Code with all systems
coding

# Or specify a project directory
coding --project ~/my-project

View Knowledge Graph¶

vkb  # Opens browser to http://localhost:8080

Update Knowledge Base¶

Within a Claude Code session:

# Incremental analysis (recent changes)
"ukb" or "update knowledge base"

# Full analysis (entire codebase history)
"ukb full" or "fully update knowledge base"

# Debug mode (single-stepping)
"ukb debug"

Next Steps¶