Forge Orchestrator

forge-orchestrator

ステージ：アルファ。 Forge プラグインとオーケストレーターはアルファ版です。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 バイナリで、依存関係はゼロです。

単一のツール内でのマルチエージェント処理は問題なく機能します。Claude Code は20個のサブエージェントを実行し、ツールがそのオーケストレーションを内部で管理するため、各エージェントは連携を保てます。問題は複数ツールの利用です。同じリポジトリで複数のAIコーディングツールを使っても、共有状態がありません。オーケストレーターはこの問題を解決します。現在は Claude Code に対応し、Codex CLI と Antigravity CLI（agy）をタスクランナーとして使用します。オーケストレーターは agy をタスクランナーとして起動します。Forge が agy 上でほかに何を行うかは測定中です（build B1、目標 2026-10-27）。

ファイルロック、ナレッジの記録、タスク計画、ドリフト検出、複数ツールのオーケストレーションを開発ワークフローに追加します。各ツールは単一の状態ディレクトリから読み書きします。12個のツールを備えた MCP サーバーが、接続中のすべてのAIクライアントにオーケストレーション状態全体を公開し、タスクの作成、取得、完了ができます。

このオーケストレーターは、同じコードベース上で2つの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 に、チェック付きの1行を追加して、そのディレクトリを PATH に加えます。シェル設定ファイルを変更しない場合は、FORGE_NO_MODIFY_PATH=1 を設定してください。

claude CLI が PATH 上にある場合、インストーラーはその CLI のみを使用して Forge の MCP ツールを Claude Code に追加します。nxtg-forge マーケットプレイス（nxtg-ai/forge-plugin）を追加して更新し、すでにインストール済みなら nxtg-forge@nxtg-forge を更新し、コンパニオンプラグイン nxtg-forge-orchestrator@nxtg-forge をインストールします。変更ごとに1行を表示し、ほかの方法で 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 は forge が stdio 経由で有効であることを示し、サーバーは 12 個のツールを含む tools/list に応答します。Codex セッション内から行うツール呼び出しは、まだ測定されていません（ビルド B1）。

クイックデモ

何もない状態からタスクボードまでの 4 つのコマンド：

# 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 — エージェントのペインを操作できる TUI ダッシュボードを起動します

過去の実績：Stargate モード（v1.6.1 より前）

94 行の仕様書をもとに、以前のバージョンのオーケストレーターが 3 つの 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

3 社。3 つのツール。1 つのオーケストレーター。1 つのコマンド：

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 サーバー	forge_create_task を含む 12 個のツールに、stdio 経由で接続された任意の AI ツールからアクセスできます

主なコマンド

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 引数内でエージェント ID gemini を維持するため、既存のプロジェクトでも引き続き動作します。各ツールはそれぞれの設定形式を読み込みます。Forge 独自の設定言語はありません。

ファイルロックの仕組み

ファイルロックがあるのは、編集の競合によってチームが何日も無駄にするのを目の当たりにしてきたからです。

Claude Code がファイルの編集を開始すると、オーケストレーターは .forge/locks/ に排他的なロックを取得します。同じファイルを要求する Codex CLI は、誰がロックを保持しているかを通知されたうえでキューに入ります。ロックにはタイムアウト（クラッシュしたツールがロックを永久に保持することはありません）とデッドロック検出が含まれます。

テストスイートでは、同時アクセス、タイムアウトの動作、複数アダプターでのロック、エッジケースを検証します。

ナレッジのフライホイールの仕組み

スプリントの合間に決定事項が消えてしまうのを目にしてきたからこそ、ナレッジのフライホイールが生まれました。

ツールセッションでの決定事項、パターン、学びはすべて .forge/knowledge/ に記録されます。エントリーはカテゴリごとに自動分類されます。セッション間やツール間を横断して検索できます。Claude Code のセッション中に記録されたナレッジは、翌日には Codex CLI から利用できます。

1 週間もすれば、システムはあなた自身が覚えている以上に、あなたの規約を把握しています。新しいセッションは、ゼロからではなく、コンテキストを引き継いで開始します。

アップグレードパス

TUI ダッシュボードですべてを確認できます。Forge UI なら、さらに見やすくなります。

ビジュアルダッシュボード。ガバナンス HUD。リアルタイムのエージェント連携ネットワーク。そして Infinity Terminal。ブラウザーを閉じても、ネットワークが切断されても、サーバーが再起動しても、セッションが維持されます。SSH パイプの切断によって 3 時間のエージェントセッションを失ったことがあるなら、これが重要な理由はおわかりでしょう。

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

リンク

• Forge 製品ページ
• Forge プラグイン（L1：バイブコーダー）
• Forge UI（L3：シップロード）
• ドキュメント
• MCP レジストリ：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 をご覧ください。