forge-orchestrator

Overview

Forge Orchestrator is a sophisticated MCP server designed to coordinate multiple AI coding tools on shared repositories. It solves the problem of multiple AI tools working on the same codebase without shared state, providing file locking to prevent conflicts, knowledge capture to maintain decision context across sessions, and drift detection to ensure work stays aligned with specifications. The server exposes 11 tools through MCP stdio protocol, making it compatible with any connected AI client. Built in Rust as a single binary with no runtime dependencies, it's designed for both interactive dashboard use and headless autonomous execution.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• init

  Initialize Forge in a project with state, event log, and knowledge base

  Try:Initialize Forge in my current project directoryTry:Set up a new Forge workspace
• plan_generate

  Generate task plan from specifications by decomposing into dependency-aware tasks

  Try:Generate tasks from my READMETry:Create a task plan from my project specification
• dashboard

  Launch the TUI dashboard with live tool panes and task status

  Try:Show me the Forge dashboardTry:Launch the interactive agent dashboard
• run

  Execute tasks headlessly in autonomous mode for CI/CD pipelines

  Try:Run all planned tasks automaticallyTry:Execute tasks in headless mode
• status

  Show current state summary including task assignments and dependencies

  Try:What's the current task statusTry:Show me the project health summary
• verify

  Run automated acceptance tests on the project

  Try:Run verification tests on my tasksTry:Check if all tasks are completed correctly
• uat

  Run interactive user acceptance tests

  Try:Run interactive acceptance testsTry:Test the implemented features manually
• ship

  Release ceremony with changelog generation, archiving, and tagging

  Try:Prepare a release of my projectTry:Generate changelog and tag the release
• config_brain

  Configure the AI brain with openai API key or rule-based approach

  Try:Configure OpenAI as the AI brainTry:Set up rule-based AI configuration
• drift_detection

  Compare in-progress work against specifications to detect divergence

  Try:Check if my implementation matches the specificationsTry:Detect any drift from the original plan
• file_locking

  Acquire or release exclusive file locks to prevent conflicting edits

  Try:Lock a file to prevent other tools from editing itTry:Check which files are currently locked

Note: Tool names inferred from CLI commands in the README. While it mentions there are 11 MCP tools, the exact MCP API signatures and tool names aren't explicitly documented, only the CLI commands. Tools like 'drift_detection' and 'file_locking'

Comparable tools

Installation

curl -fsSL https://forge.nxtg.ai/install.sh | sh
forge init

{
  "mcpServers": {
    "forge": {
      "command": "forge",
      "args": ["mcp"]
    }
  }
}

git clone https://github.com/nxtg-ai/forge-orchestrator
cargo build --release

FAQ

What AI tools does Forge Orchestrator support?

It supports Claude Code (via MCP stdio), Codex CLI, and Gemini CLI (via filesystem). Each tool adapter reads its own config format without requiring a specific configuration language.

How does file locking work?

When a tool starts editing a file, Forge acquires an exclusive lock in .forge/locks/. Other tools requesting the same file are queued and notified. The system includes timeouts for crashed tools and deadlock detection, tested with 378 test cases covering concurrent access scenarios.

What is the knowledge flywheel?

The knowledge flywheel captures decisions, patterns, and learnings from all tool sessions in .forge/knowledge/. Entries are auto-classified and searchable across tools and sessions. This context is preserved for future use, allowing new sessions to start with accumulated knowledge rather than from scratch.

On Hacker News

Recent discussion from the developer community.

• Show HN: Forge – 3MB Rust binary that coordinates multi-AI coding agents via MCP▲ 1💬 1
  Story by vipdestiny · 2026-02-09

Compare forge-orchestrator with