forge
Enables parallel execution in isolated git worktrees for task processing, allowing multiple workers to operate independently while maintaining version control and isolation during feature development.
Integrates with GitHub Actions for continuous integration workflows and badge display, and serves as the hosting platform for the MCP server repository and plugin marketplace distribution.
Forge
Structured planning, parallel execution, and deep validation for Claude Code.
Install
claude plugin marketplace add TT-Wang/forge
claude plugin install forge@tt-wang-pluginsWhat it does
Forge turns a vague objective into structured, validated, parallel work. You say /forge add JWT auth with refresh tokens and it plans, executes in parallel worktrees, validates deeply, retries intelligently, and learns for next time.
Plans — breaks tasks into a dependency graph of modules
Executes — parallel workers in isolated git worktrees
Validates — syntax checks, API contract verification, stagnation detection
Retries — debugger agent with root-cause analysis on failures
Reviews — correctness and security checks with contract verification
Learns — saves conventions and failure patterns to memory
Resumes — picks up where you left off after a crash
Usage
/forge add JWT authentication with refresh tokens
/forge-status
/forge-validate m2Use Forge for multi-file features, tasks that need validation, ambitious changes. Skip it for quick edits or simple questions — just use Claude Code directly.
How it works
┌─────────────────────────────────────────────────────────────┐
│ /forge "add JWT auth with refresh tokens" │
└──────────────────────────┬──────────────────────────────────┘
│
▼
┌────────────────────────┐
│ Forge Orchestrator │
│ skills/forge/SKILL │
└─────┬──────────────────┘
│
┌───────────────┼───────────────┬───────────────┐
▼ ▼ ▼ ▼
┌────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
│Planner │ │ Worker │ │ Reviewer │ │ Debugger │
│ │ │ (×N │ │ │ │ │
│ Explore│ │ parallel)│ │ Security │ │ Root │
│ codebase │ │ │ + API │ │ cause │
│ → DAG │ │ Isolated │ │ contract │ │ analysis │
│ plan │ │ worktree │ │ checks │ │ + logs │
└────┬───┘ └────┬─────┘ └────┬─────┘ └────┬─────┘
│ │ │ │
└────────────┴───────┬───────┴───────────────┘
│
▼
┌────────────────────────┐
│ MCP Server │
│ (Node.js, 7 tools) │
│ │
│ validate │
│ validate_plan │
│ memory_recall/save │
│ iteration_state │
│ forge_logs │
│ session_state │
└───────────┬────────────┘
│
▼
┌────────────────────────┐
│ .forge/ (persistent) │
│ │
│ plans/ memory/ │
│ iterations/ logs/ │
│ state/ │
└────────────────────────┘4 agents + 1 MCP server (7 tools) + 3 slash commands. All markdown and Node.js — no custom runtime.
MCP Tools
Tool | What |
| Syntax checks, API contracts, stagnation/velocity/oscillation analysis |
| DAG cycle detection, file overlap warnings, schema validation |
| Search project and global memory |
| Persist learned patterns with deduplication |
| Track retry attempts per module |
| Query structured JSONL logs by run, module, phase, severity |
| Save/load session state for resumability |
Development
See CONTRIBUTING.md for dev setup, test commands, and the PR process. See SECURITY.md for how to report vulnerabilities privately.
git clone https://github.com/TT-Wang/forge.git
cd forge/forge-mcp-server
npm install
npm testDocumentation
Architecture — orchestrator, agents, MCP server, state
MCP tools reference — input/output schemas for all 7 tools
Changelog — release notes
Works great with
memem — Persistent cross-session memory for Claude Code. Forge + memem is the recommended pairing: forge plans and executes, memem remembers what worked across runs. Patterns forge saves via
memory_saveland in memem's recall index, so next week's run starts with last week's lessons already loaded.
See Also
Vibereader — Curated tech news while Claude works
License
MIT — see LICENSE
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/TT-Wang/forge'
If you have feedback or need assistance with the MCP directory API, please join our Discord server