Forge Orchestrator

forge-orchestrator

阶段：Alpha。 Forge 插件和编排器目前处于 Alpha 阶段。2026-10-15（UTC），独立的 NXTG.AI 团队（product-oracle）在全新安装的插件（v3.14.0）和编排器（forge 1.7.0）上运行了预先注册的核心任务测试。测试通过；每项重复检查均通过 3 次（共 3 次，run 7）。证据附在 forge-plugin v3.14.0 发布版本中。不提供 SLA；接口可能随时变更，恕不另行通知。

为共享仓库上的 Claude Code 提供编排，并使用 Codex CLI 和 Antigravity CLI（agy）作为任务运行器——单个 Rust 二进制文件，零依赖。

在单个工具内部运行多 Agent 效果很好。Claude Code 可以运行 20 个子 Agent，并让它们保持协同，因为该工具会在内部管理编排。问题在于多工具协作：多个 AI 编码工具在同一个仓库中工作，却没有共享状态。这正是编排器要解决的问题：目前支持 Claude Code，并使用 Codex CLI 和 Antigravity CLI（agy）作为任务运行器。编排器会将 agy 作为任务运行器启动；Forge 在 agy 上的其他功能仍在测量中（构建 B1，目标日期为 2026-10-27）。

它为你的开发工作流添加文件锁定、知识捕获、任务规划、偏差检测和多工具编排。各工具从单一状态目录读取和写入数据。一个包含 12 个工具的 MCP 服务会向任何已连接的 AI 客户端公开完整的编排状态，并可创建、认领和完成任务。

创建编排器的原因是，我曾让两个 AI 工具在同一个代码库上工作，并眼看着它们像人类团队一样以相同的方式失败。Claude 重构了一个模块。Codex 根据重构前的接口更新了测试。两边都保存了更改。测试失败了。两个工具都不知道对方的存在。我曾花 23 年观察才华横溢的人类团队遇到这种完全相同的情况。解决方案始终如一：编排基础设施。

安装

curl -fsSL https://forge.nxtg.ai/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"   # this shell only; new shells already have it
forge init

安装程序会安装固定版本 Forge v1.7.1，而不是最新发布的版本。它会将 forge 放入 ~/.local/bin（可通过 FORGE_INSTALL_DIR 更改），并在 ~/.profile、~/.bashrc 以及（如果你使用 zsh）~/.zshenv 中添加一行带保护条件的配置，将该目录加入 PATH。设置 FORGE_NO_MODIFY_PATH=1 可让安装程序不修改你的 shell 文件。

如果 claude CLI 位于 PATH 中，安装程序随后只会使用该 CLI，将 Forge 的 MCP 工具添加到 Claude Code：添加并刷新 nxtg-forge 市场（nxtg-ai/forge-plugin），如果你已安装 nxtg-forge@nxtg-forge，则更新它，并安装配套插件 nxtg-forge-orchestrator@nxtg-forge。每项更改都会打印一行，除此之外不会以任何方式更改 Claude 配置。如果没有 claude，或者某个步骤失败，安装程序会打印供你运行的命令，并仍以 0 退出。设置 FORGE_NO_CLAUDE_PLUGIN=1 可跳过此步骤。

单个二进制文件。无运行时依赖。

将 Codex CLI 连接到 MCP 服务

将编排器的 MCP 服务注册到 Codex CLI，然后检查 Codex 是否列出了该服务：

codex mcp add forge -- forge mcp
codex mcp list

这会将条目写入 ~/.codex/config.toml：

[mcp_servers.forge]
command = "forge"
args = ["mcp"]

该服务会处理其启动目录中的项目。若要固定一个项目，请在注册时绑定它：codex mcp add forge --env FORGE_PROJECT_ROOT=/path/to/project -- forge mcp。已在 codex-cli 0.162.1 中验证：codex mcp list 会显示通过 stdio 启用的 forge，且该服务会通过 tools/list 返回其 12 个工具。在 Codex 会话中进行的工具调用尚未测量（构建 B1）。

快速演示

从零开始，四条命令即可创建任务看板：

# 1. Initialize — creates .forge/ directory with state, event log, knowledge base
forge init

# 2. Configure the AI brain — choose 'openai' (needs API key) or 'rule-based' (free)
forge config brain openai

# 3. Generate tasks — reads your SPEC.md or README, creates dependency-aware task graph
forge plan --generate

# 4. See the result — task board with assignments, dependencies, and project health
forge status

接下来你可以：

• forge run — 以无头模式执行任务（自主模式，非常适合 CI）
• forge dashboard --pty — 启动带有交互式 Agent 面板的 TUI 仪表板

以往成果：星际之门模式（v1.6.1 之前）

根据一份 94 行的规格说明，编排器的早期版本曾协调三个 AI 编码工具，构建出一套完整的 CLI 工具集。该次运行使用的是已弃用的 Gemini CLI；从 v1.6.1 起，适配器改为启动 Antigravity CLI（agy），且尚未重新测量该次运行结果。

SPEC.md (94 lines) → forge plan --generate → 15 tasks

Claude Code:  6 design tasks     → completed
Codex CLI:    6 implementation   → completed
Gemini CLI:   3 test/doc tasks   → completed   (pre-1.6.1 adapter)

Result: 5,306 lines of working code
        10 auto-committed git entries
        13 Python files (CLI + tests)
        Zero file conflicts

三家公司。三个工具。一个编排器。一条命令：

forge dashboard --pty

功能一览

功能	作用
文件锁定	独占锁可防止工具同时编辑同一个文件
知识飞轮	跨工具捕获决策、模式和经验。自动分类并支持搜索。
计划生成	forge plan --generate 将规格说明分解为考虑依赖关系的任务图
偏差检测	将已完成任务与 SPEC.md 进行比较。需要使用 openai 大脑；默认的基于规则的大脑不会评估偏差
任务看板	跟踪依赖关系的任务、工具分配和进度监控
多工具适配器	Claude Code（MCP stdio）；Codex CLI 和 Antigravity CLI（agy）作为任务运行器（文件系统）。Codex CLI 也可以注册 MCP 服务（见下文）
TUI 仪表板	forge dashboard：实时工具面板、任务状态、锁定状态
无头模式	forge run：为 CI/CD 流水线自主执行任务
MCP 服务	通过 stdio 向任何已连接的 AI 工具提供 12 个工具，包括 forge_create_task

关键命令

forge init                     # Initialize Forge in a project
forge plan --generate          # Generate task plan from spec
forge dashboard                # Live TUI dashboard
forge dashboard --pty          # TUI with interactive agent panes (Stargate)
forge run                      # Headless autonomous mode
forge status                   # Current state summary
forge verify                   # Run automated acceptance tests
forge uat                      # Interactive UAT test runner
forge ship                     # Release ceremony: changelog, archive, tag

架构

编排器是 Forge 的策略核心。所有治理规则、文件锁和编排逻辑都在这里。插件（L1：Vibe Coder）和 UI（L3：Ship Lord）是适配器界面。它们通过不同界面呈现编排器的状态，但不制定策略决策。

┌──────────────────────────────────────┐
│        forge-orchestrator            │
│        (Rust)                        │
│                                      │
│  File locking · Task planning        │
│  Knowledge · Governance · MCP        │
│  Multi-tool adapters                 │
│                                      │
│  Policy enforced here.               │
│  Nowhere else.                       │
└───────────┬──────────────────┬───────┘
            │                  │
   ┌────────┴────────┐  ┌────┴────────┐
   │  forge-plugin   │  │  forge-ui   │
   │  (L1 Safety)    │  │  (L3 MC)    │
   │  Claude Code    │  │  React      │
   │  adapter        │  │  dashboard  │
   └─────────────────┘  └─────────────┘

通信：.forge/ 文件系统 + MCP stdio。没有守护进程。没有数据库。状态以文件形式保存。

工具适配器：Claude Code 使用 MCP stdio。Codex CLI 和 Antigravity CLI（agy）通过文件系统约定运行任务。agy 适配器会在任务文件、配置键和 MCP 参数中保留 Agent ID gemini，以便现有项目继续正常工作。每个工具都读取自己的配置格式。没有 Forge 专用配置语言。

文件锁定的工作原理

之所以需要文件锁定，是因为我亲眼见过团队因编辑冲突而损失数天时间。

Claude Code 开始编辑文件时，编排器会在 .forge/locks/ 中获取独占锁。Codex CLI 若请求同一个文件，则会进入队列，并收到锁持有者的通知。锁包含超时时间（崩溃的工具不会永远持有锁），并支持死锁检测。

测试套件涵盖并发访问、超时行为、多适配器锁定和边界情况。

知识飞轮如何运作

之所以有知识飞轮，是因为我亲眼见过决策在一个个冲刺之间消失。

工具会话中的每项决策、模式和经验都会记录在 .forge/knowledge/ 中。条目会按类别自动分类。可跨会话、跨工具搜索。在 Claude Code 会话中捕获的知识，第二天就能供 Codex CLI 使用。

一周后，系统对你惯例的了解会超过你自己的记忆。新会话一开始就有上下文，不必从头开始。

升级路径

TUI 仪表板能展示所有内容。Forge UI 则能展示得更好。

可视化仪表板。治理 HUD。实时 Agent 协作网络。还有 Infinity Terminal：即使关闭浏览器、网络中断或服务器重启，会话也能继续。如果你曾因 SSH 管道断开而丢失持续 3 小时的 Agent 会话，就会明白这有多重要。

git clone https://github.com/nxtg-ai/forge-ui && cd forge-ui && npm install && npm run dev

链接

• Forge 产品页面
• Forge 插件（L1：氛围编码者）
• Forge UI（L3：发布达人）
• 文档
• MCP Registry：mcp-name: io.github.nxtg-ai/forge-orchestrator

许可证

源代码依据 Functional Source License 1.1 (FSL-1.1-ALv2) 提供。将于 2028-03-18 转为 Apache License 2.0。完整条款请参阅 LICENSE.md。