Package Exports
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (forge-pipeline) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
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:
- Spec — Architect writes spec, Challenger reviews it (up to 3 rounds)
- Plan — Coordinator decomposes spec into parallel work units
- Implement — Lead agents spawn Worker agents in isolated git worktrees
- Integrate — All branches merged, conflicts resolved, tests run
- Audit — Senior auditor spawns junior auditors for security, quality, testing review
- Fix — Audit findings routed back for fixes (up to 2 rounds)
- Finalize — Merge to main, generate summary report
Requirements
git— version controltmux— session management for parallel agentsclaude— Claude Code CLIjq— JSON processing
Optional
- Augment codebase-retrieval — Semantic code search for better results. Auto-detected if configured.