Agent Bridge

Codex が Claude Code と DeepSeek Harness を監督する。Bridge 自身は LLM を呼び出さない。

Codex だけを唯一の監督者にする。Claude Code または DeepSeek Harness が実装を行う。あなたは Codex 内で確認、検証、適用する。

一つのコマンド

npx -y codex-agent-bridge

その後 新しい Codex セッションを開始する。bridge_* ツールが表示される。

このコマンドは：ランタイムを ~/.agent-bridge にインストールし、Codex Skill と MCP（npx.cmd ではなくローカルの node.exe を使用）を書き込み、doctor を一度実行する。

更新するには同じコマンドを再度実行する。アンインストール：

npx -y codex-agent-bridge uninstall
npx -y codex-agent-bridge uninstall --purge

--purge で ~/.agent-bridge が削除される。

事前に必要なもの

サポート対象外

• Claude Code / DeepSeek Harness のインストール補助はしない

• それらの model / provider / reasoning effort は変更しない

• いかなる LLM も呼び出さない

利用可能な Worker があれば、それを割り当てる。一つもない場合、doctor がその旨を示す。

Related MCP server: cc-agent

機能

Codex  ──bridge_run──►  Claude Code / DeepSeek Harness
  ▲                         │
  │      ReviewPacket       │  在独立 worktree 里改代码
  │      verification       │  不得 commit / push / merge
  └──── bridge_apply ◄──────┘

クローズドループ：

bridge_run
→ WAITING_FOR_INPUT 时 bridge_respond
→ AWAITING_REVIEW + ReviewPacket
→ bridge_approve     任务分支 checkpoint，不是完成发布
→ bridge_apply       cherry-pick 到当前分支，不是 merge

Turn 終了 ≠ タスク完了。Diff は baseCommit と worktree のみを認識する。

bridge_run は worker のみを選択する：claude または deepseek（デバッグ時は replay / fake も可）。model / provider / effort は渡さない。

DeepSeek Harness が一般的なパスにない場合は、AGENT_BRIDGE_DEEPSEEK_ROOT を設定する。

使用上の注意

• 対象は独立した git リポジトリである必要がある。bridge_* を呼ぶたびに同じ project を指定する。タスク UUID のフィールド名は task。

• 同一プロジェクトで同時に Writer になれるのは一つだけ。2 番目の書き手は CORE_LOCK_HELD を返す。

• MCP を変更した場合は Codex を再起動する必要がある。古いセッションでは新しいツールは表示されない。

• 破損した tasks.json は TASK_STORE_CORRUPTED を返し、空のストアとして扱われない。

新バージョンの公開

ローカルでの npm publish は毎回 2FA を要求する。これは npm の仕様であり、git push のようにパスワード不要にはできない。

正しい手順：バージョン変更 → tag を作成 → push する。GitHub Actions が Trusted Publishing を使用して npm に公開するため、パスワード入力は不要。

一度だけの設定（最初だけ）：codex-agent-bridge の npm 設定 を開く → Trusted Publisher → GitHub Actions、以下の項目を入力：

以降、毎回：

# 先改 package.json 里的 version，提交
git tag v1.2.0
git push origin main --tags

ソースから開発する場合

npm install
npx tsx src/cli.ts setup --dev
npm test

--dev により MCP が ~/.agent-bridge ではなく現在のリポジトリを指すようになる。

ドキュメント

リポジトリディレクトリは Agent Relay のままである場合がある。製品名は Agent Bridge。npm パッケージ名は codex-agent-bridge。