Use the claw-forge CLI to run autonomous coding agents on a project until all features pass. Covers the full workflow: init → spec → plan → run → status → ui. Use when a user asks to build a project with claw-forge, run agents on a codebase, generate a feature DAG, manage the provider pool, or fix bugs with the reproduce-first protocol.
claw-forge is a multi-provider autonomous coding agent harness.
Agents run in parallel, claim features from a dependency DAG, and keep working
until every feature passes — or you stop them.
GitHub: https://github.com/clawinfra/claw-forge
PyPI: https://pypi.org/project/claw-forge/
pip install claw-forge
# or (recommended):
uv pip install claw-forge
cd my-project
claw-forge init
Creates:
CLAUDE.md — agent instructions (stack-aware).claude/ — slash commands (/create-spec, etc.)claw-forge.yaml — provider pool config.env.example — API key templateCreate app_spec.txt (plain text) or app_spec.xml (structured XML):
Project: My App
Stack: Python, FastAPI, SQLite
Authentication:
- JWT login endpoint
- Token refresh
- Session management
Dashboard:
- Real-time stats via WebSocket
- Export CSV
Or use the Claude slash command inside Claude Code: /create-spec
claw-forge plan app_spec.txt
.claw-forge/state.db# Use Sonnet if cost matters more
claw-forge plan app_spec.txt --model claude-sonnet-4-6
claw-forge run
Default: 5 parallel coding agents, reads claw-forge.yaml.
# More concurrency
claw-forge run --concurrency 8
# Pin a specific model
claw-forge run --model claude-opus-4-6
# YOLO mode — skip human-input gates, max speed, aggressive retry
claw-forge run --yolo
# Preview without executing
claw-forge run --dry-run
# Use hashline edit mode (better for weaker models — 6.7%→68.3% benchmark)
claw-forge run --edit-mode hashline
claw-forge status
Shows: passing/failing/running/pending feature counts, recommended next action.
claw-forge ui
Opens a browser-based Kanban board at http://localhost:8888.
Shows real-time agent activity, feature status, costs, and logs.
| Command | Purpose |
|---|---|
init | Bootstrap project (CLAUDE.md, config, slash commands) |
plan <spec> | Parse spec → feature DAG in state DB |
run | Run agents until all features pass |
status | Show progress and recommended next action |
ui | Launch Kanban UI at localhost:8888 |
dev | Start API + Vite dev server (for UI development) |
add <spec> | Add features to an existing project (brownfield) |
pause | Drain mode: finish in-flight, start no new agents |
resume | Resume after pause |
fix <desc> | Fix a bug using RED→GREEN reproduce-first protocol |
merge | Squash-merge a feature branch to target |
input | Answer pending human-input questions interactively |
pool-status | Show provider pool health and current routing |
state | Start the AgentStateService REST + WebSocket API |
claw-forge.yaml# Provider pool — add as many as you have keys for