Forge Documentation
Learn how to use Forge — the terminal MCP server that gives AI coding agents persistent PTY sessions, multi-agent orchestration, and a real-time dashboard.
Get started in seconds:
claude mcp add --transport http forge http://127.0.0.1:3141/mcp
Getting Started
Install Forge, connect it to your agent, and run your first command in 60 seconds.
Guides
Best practices, multi-agent workflows, dashboard setup, session templates, and more.
Tools Reference
Complete reference for all 23 MCP tools with parameters, examples, and return values.
Configuration
CLI flags, environment variables, defaults, and configuration examples.
Architecture
System design, ring buffer internals, data flow, and key design decisions.
What is Forge?
AI coding agents (Claude Code, Codex, Gemini CLI) typically run one command at a time. Forge gives them persistent terminals — run your React frontend, Java API, and Postgres migrations in parallel, monitor all three, and only read what changed.
Forge works with any MCP-compatible client via stdio or HTTP transport.
Real PTY
Same node-pty lib as VS Code. Colors, signals, TUI apps all work.
Incremental Reads
Ring buffer with per-consumer cursors. Up to 90% context token savings.
23 MCP Tools
Session lifecycle, I/O, search, events, delegation, and ops.
Supported Agents
Claude Code
stdio or HTTP
Codex
HTTP MCP
Any MCP Client
stdio or HTTP