Forge

Autonomous multi-agent coding pipeline. Give it a task, walk away, come back to finished code.

Quick Start

# Clone and set up
git clone <repo-url> ~/forge
chmod +x ~/forge/forge
export PATH="$HOME/forge:$PATH"  # Add to your shell profile

# Initialize a new project
forge init my-project
cd my-project
forge start "Build a REST API with user authentication"

# Or use with an existing project
cd my-existing-project
forge init
forge start "Add rate limiting to all API endpoints"

Commands

| Command | Description | |---------|-------------| | forge init [name] | Initialize a project (creates git repo if needed) | | forge start "task" | Run the full autonomous pipeline | | forge run "task" | Alias for start | | forge status | Show current phase and active agents | | forge logs [agent] | View agent logs | | forge abort | Kill all running agents | | forge clean | Remove .forge/ directory and temp branches |

Options

| Option | Default | Description | |--------|---------|-------------| | --max-workers N | 4 | Max parallel workers per lead | | --max-leads N | 4 | Max parallel leads | | --audit-rounds N | 2 | Max audit-fix cycles | | --timeout N | 60 | Timeout in minutes | | --dry-run | - | Only run spec + planning phases | | --verbose | - | Show real-time output |

How It Works

Forge runs 7 phases automatically:

0. Spec — Architect writes spec, Challenger reviews it (up to 3 rounds)
1. Plan — Coordinator decomposes spec into parallel work units
2. Implement — Lead agents spawn Worker agents in isolated git worktrees
3. Integrate — All branches merged, conflicts resolved, tests run
4. Audit — Senior auditor spawns junior auditors for security, quality, testing review
5. Fix — Audit findings routed back for fixes (up to 2 rounds)
6. Finalize — Merge to main, generate summary report

Requirements

• git — version control
• tmux — session management for parallel agents
• claude — Claude Code CLI
• jq — JSON processing

Optional

• Augment codebase-retrieval — Semantic code search for better results. Auto-detected if configured.