CoS Codex Bridge

CoS Codex Bridge

あなたの Chief of Staff が、Codex も担当します。

Chief of Staff クライアントから Codex のタスクを検索し、プロジェクト作業を作成し、プロンプト全体を送信して、進捗を確認し、同じ会話を続けられるローカル MCP サーバーです。同じ MCP で利用できるオプションの Claude Code CLI 経由の機能では、ローカルのプロジェクトフォルダーと保存済みの CLI セッションを使用します。コア機能は無料の MIT ライセンスです。ブリッジのサブスクリプションや決済はありません。実際に実行するには、お使いの Codex または Claude Code へのアクセス権が必要です。

リリースを選択してください： npm の安定版 0.1.4 は Codex のみをサポートします（@latest）。0.2.0-beta.1 では、同じ MCP に Claude Code CLI のサポートが追加されます（@beta）。ローカルにインストールしてクライアントを接続したら、bridge_* ツールを使用します。デーモンや Desktop-owner アダプターのインストールは不要です。Codex のコアワークフローと Grok Bot から Claude Code CLI への引き継ぎは、macOS でオーナーによる実地テストを完了しています。Desktop が管理する一時停止キューの復旧は、既知の Codex の制限事項です。新しいバージョンの Codex Desktop でのサイドバー表示は動作保証されていません。利用する前に互換性テーブルを確認してください。キューへの登録通知は、作業が開始された証拠にはなりません。

このブリッジは、公式 MCP Registry と Glama に登録されています。これらは検索用のリストです。ブリッジは引き続きローカルにインストールして実行します。

Chief of Staff でできること

• 調査内容や製品アイデアを、新しい Codex プロジェクトとタスクに変換します。
• 手動でコピー＆ペーストすることなく、プロンプト全体と添付テキストを送信します。
• 既存の Codex タスクを見つけ、進捗を確認して、同じ会話を続けます。
• プロンプトが受け付けられただけで実行されたと思い込まず、永続的な受領記録で作業の進行状況を追跡します。
• 許可されたプロジェクト全体で、対象を限定した作業の名前変更、割り当て、ピン留め、キャンセルを行います。
• 明示的な許可リストに登録されたディレクトリ内に、ローカルプロジェクトへのアクセスを制限します。

例：「このアイデアのプロジェクトを作成して、調査結果を Codex に送信し、ビルドを監視して、レビュー結果を同じタスクでフォローアップしてください。」

Claude Code ルート（ベータ版）

同じ MCP で、Claude Code CLI の作業を開始し、続けられるようになりました。bridge_projects、bridge_sessions、bridge_submit に provider:"claude-code" を渡してください。既存の Codex ルートは引き続きデフォルトです。ローカルフォルダーが Claude Code のプロジェクトコンテキストになります。ブリッジはそのフォルダーに保存済み CLI セッションを作成し、永続的なレシートを返し、結果を読み取り、同じセッションでフォローアップします。使い捨てフォルダー内で実際にファイルを編集するテストを含め、Claude Code 2.1.269 でローカルテスト済みです。

オーナーによるフィールドテストでは、Grok Bot Chief of Staff がインストール済みの MCP を使って許可リストに登録されたフォルダーを作成し、Claude Code にプロンプトを送信して完了結果を読み取り、同じ保存済みセッションでフォローアップしました。両方のブリッジレシートと Claude Code のネイティブなセッション履歴を確認しました。これはローカル CLI の引き渡しを証明するものであり、Claude Desktop やアカウントの Project の操作を証明するものではありません。

Claude アカウントの Projects、通常のチャット、Cowork／Dispatch、Desktop が所有するセッションは、それぞれ別の環境です。このルートでは、それらを作成したり操作したりすることはありません。また、CLI セッションが Claude Desktop のサイドバーに自動的に表示されることもありません。Claude のセットアップ、具体的なワークフロー、制限事項。

引き渡しを見る

アニメーションはローカルでの引き渡しを示しています。個人の Desktop データやプロジェクトのスクリーンショットは使用していません。

安全なデモを試す

初めての方は、アカウント不要のクイックスタートから始めてください。 安定版 npm パッケージを使用するため、Git クローンは不要です。また、完了したレシートの例を確認できます。ご利用のローカル MCP クライアントも含めて、インストール結果を報告してください。

この手順では、Codex アカウント、モデル呼び出し、プロジェクトの変更なしで、MCP ワークフローをローカルで試せます。

このクローンでは GitHub の main を使用します。現在は Claude Code CLI のプレビュー版（0.2.0-beta.1）です。代わりに安定版の Codex 専用ソースをデモするには、cd cos-codex-bridge の後、npm ci の前に git checkout v0.1.4 を実行してください。

git clone https://github.com/AV-Labs-Co/cos-codex-bridge.git
cd cos-codex-bridge
npm ci
npm run demo

デモでは、完了したレシート、ペイロードのハッシュ、タスクのメタデータが表示されるため、実際のプロジェクトへのアクセスを許可する前にブリッジの仕様を確認できます。

最も簡単なセットアップ：このリンクをローカルアシスタントに渡す

リポジトリとインストール手順を開く。ローカルターミナルにアクセスできるアシスタントなら、代わりにインストールできます。ブラウザーのみ、またはクラウドのみで利用するチャットでは、お使いのコンピューターにソフトウェアをインストールできません。

このインストール依頼を Chief of Staff にコピーしてください。

https://github.com/AV-Labs-Co/cos-codex-bridge から CoS Codex Bridge をインストールしてください。最初に README と SECURITY.md を読んでください。私が承認したプロジェクトフォルダーだけを使用し、読み取り専用のデフォルト設定を維持して、既存のクライアント設定を保持してください。インストーラーの手順に従い、doctor を実行して、生成された stdio MCP エントリーをローカルクライアントに接続してください。どの項目が成功し、何のセットアップがまだ必要かを教えてください。最初のタスクを送信するまでは、作業を送信しないでください。何も公開またはデプロイしないでください。

Releases からソースアーカイブをダウンロードして展開し、以下の手順に従うこともできます。Git クローンを使うと、後からの更新が簡単になります。公開 npm パッケージも利用できますが、ホストされたエンドポイントは不要です。

インストール

Node.js 22 以降、npm、Codex の作業にはローカルで認証済みの Codex CLI、Claude の作業には Claude Code CLI のいずれか、または両方と、stdio MCP に対応するローカルクライアントが必要です。Codex Desktop への登録には、さらに macOS 上の Codex Desktop が必要です。

以下の Git clone では、Claude Code CLI のプレビュー版（0.2.0-beta.1）である現在の main ブランチをインストールします。安定版の Codex 専用ソースを使う場合は、cd cos-codex-bridge の直後、npm ci の前に git checkout v0.1.4 を実行してください。以下の固定バージョン npm コマンド @0.1.4 は、安定版のインストール方法です。

git clone https://github.com/AV-Labs-Co/cos-codex-bridge.git
cd cos-codex-bridge
npm ci
npm test
node scripts/install.mjs --root /absolute/path/to/your/projects

インストーラーは、~/.local/share/cos-codex-bridge の下に専用の設定ファイル、ランチャー、MCP スニペットを書き込みます。チェックアウト先はそのまま保持してください。デフォルトの実行モードは読み取り専用です。承認済みのプロジェクト編集に限り、--write を使用してください。プロジェクトのルートには具体的な場所を指定し、ホームディレクトリ全体を指定しないでください。いずれかの CLI が MCP クライアントの PATH 上にない場合は、--codex /absolute/path/to/codex または --claude /absolute/path/to/claude を追加してください。インストーラーとアップグレードの手順を参照してください。

Git ではなく npm を使う場合は、専用フォルダーに固定バージョンのリリースをインストールしてから、同じローカルインストーラーを実行してください。Codex の安定版のみを使う場合は @0.1.4、Codex と Claude Code CLI のプレビュー版を使う場合は @0.2.0-beta.1 を指定してください。

mkdir -p "$HOME/.local/share/cos-codex-bridge-package"
npm install --prefix "$HOME/.local/share/cos-codex-bridge-package" [email protected]
node "$HOME/.local/share/cos-codex-bridge-package/node_modules/cos-codex-bridge/scripts/install.mjs" --root "/absolute/path/to/your/projects"

生成されたランチャーはそのパッケージフォルダーを参照するため、フォルダーは保持してください。npm を使った方法は、クリーンな安定版およびベータ版のインストール、分離されたデモ設定、doctor で確認済みです。インストーラーが MCP クライアントの設定を編集することはありません。

~/.local/share/cos-codex-bridge/cos-codex-bridge doctor

codexAvailable、claudeCodeAvailable、claudeCodeAuthenticated、mode、sandbox、roots を確認してください。Claude のサインイン確認は MCP ホストのプロセスから実行されるため、サンドボックス化されたターミナルでの結果と異なる場合があります。doctor は Desktop のサイドバー表示を検証しません。モデルを使わないデモの場合は、--demo を指定して別のプレフィックスにインストールしてください。

生成された mcp-client.json をクライアントの MCP 設定に貼り付けてください。同等の形式は次のとおりです。

{"mcpServers":{"cos-codex-bridge":{"command":"/absolute/path/to/node","args":["/absolute/path/to/cos-codex-bridge/dist/cli.js","--config","/absolute/path/to/config.json","mcp"]}}}

引き継ぎの一連の流れ

Chief of Staff に次のように伝えます。「アプリのプロジェクトを見つけ、この実装ブリーフ全体を Codex に送り、進捗を監視してから、レビュー結果を踏まえて同じタスクを続けてください。」

1. bridge_projects と bridge_sessions を使って、対象のプロジェクトとタスクを正確に特定します。
2. 必要に応じてディレクトリを作成し、登録します。ディレクトリを作成しただけでは、Desktop プロジェクトにはなりません。
3. project、プロンプト全文である prompt、安定した requestId を指定して bridge_submit を呼び出します。後続の依頼では threadId を含めてください。
4. bridge_receipt をポーリングします。ハッシュ、タスク ID、最終的な完了を確認してください。追加の確認が必要な場合は bridge_answer で対応します。
5. bridge_session_manage を使って、タスクの名前変更、割り当て、ピン留めを行います。保存されたメタデータと Desktop 上の表示は、それぞれ別個の確認材料です。

モデルが正常に完了しても、生成されたコードが動作することの証明にはなりません。結果をレビューし、テストしてください。

10 個のツール、12 個の機能、1 つの既知の制限

ツール	目的
bridge_projects	エイリアスの一覧表示、フォルダーの作成、デスクトッププロジェクトの登録・オープン・確認
bridge_sessions	外部で作成されたタスクを含む、許可済みの既存タスクの検索と読み取り
bridge_submit	開始または追加指示。安定したリクエスト ID と完全な UTF-8 ペイロードに対応
bridge_receipt	永続的な進捗、ハッシュ、上限付きの出力、明示的な不確実性
bridge_steer	既存のブリッジキュー項目を再送せずに、再試行して復旧
bridge_answer	保留中の確認に回答。権限の拡張は決して承認しません
bridge_cancel	ブリッジが管理する直接実行のキャンセルを要求
bridge_artifact	バージョン管理されたテキストアーティファクトを上書きせずに読み書き
bridge_session_manage	登録済みプロジェクトへの名前変更、ピン留め・ピン留め解除、割り当て
bridge_doctor	モード、Codex バージョン、スコープ、実際の機能上の制限を報告

既知の制限（まれに発生）： セッションにすでにアクティブなライターがいて、ステアリングプロンプトが送信されると、自然な休止点または停止点に達するまでプロンプトは待機します。自律実行が長時間続く場合、このケースで必要な人間による介入は、Steer を押すことだけです。

v1 の機能契約と検証マトリックスを参照してください。

ビジー状態のタスク、ステアリング、中断からの復旧

別のライターがタスクを所有している場合、直接送信はデフォルトで SESSION_BUSY になります。既存のデスクトップ実行ポリシーを使用するには、onBusy:"queue" と acceptDesktopPolicy:true を指定してください。delivery:"desktop-queue" は既存のタスクへの明示的なキューイングを行います。これらの経路では Codex のファーストパーティキュー API（codex queue と同等）を使用し、個別のテキスト入力と安定したクライアントメッセージ ID を維持します。

レシートでは busy、queued、steered、delivered、completed、blocked、uncertain を区別します。thread/queue/start による復旧は、ライターが利用可能な状態でローカルの実機テストに合格しています。デスクトップが所有する一時停止状態からの復旧は v0.1 では延期されており、人間が Steer をクリックする必要がある場合があります。 bridge_steer は、既存の CLI 作成項目をキュー ID で取り込んだ場合も含め、ライターが利用可能になったときに保存済みの項目を正確に再試行します。includeQueue:true を指定した bridge_sessions は、保留中の ID と推定されるステアリング要否の状態を公開します。キューの消失を配信済みと見なしたり、暗黙に別のタスクを開始したりすることはありません。キューのセマンティクスを参照してください。

セキュリティのデフォルト設定

ソースプレビュー。npm 0.1.4 または 0.2.0-beta.1 には含まれません： 直接送信で、ハンドオフごとの writeIntent を指定できるようになりました。読み取り専用のハンドオフでは書き込みを許可する設定より権限が狭まります。書き込みハンドオフで設定済みの権限を拡張することはできません。デスクトップキューでは、この経路から既存の権限を狭められないため、ハンドオフごとの明示的な意図指定を拒否します。契約と例。

デフォルト拒否の realpath 許可リスト、読み取り専用の直接実行、非公開のローカルレシート、上限付きの UTF-8 入力、明示的なプロジェクト・タスクの照合、暗黙のクラウドエンドポイントなし。レシートの整合性を保つため、プロンプトとアーティファクトはローカルにプレーンテキストで保存されます。暗号化ストレージとして扱わないでください。

直接実行ワーカーでは、継承したコネクターを無効にし、権限の承認を拒否します。デスクトップキューは、別個の明示的なポリシー境界です。既存タスクの権限とツールを使用します。ブリッジは、すでに実行中のそのタスク内で、より制限の厳しいサンドボックスを強制できません。ストアへの自動送信、ソーシャル投稿、公開は許可されていません。SECURITY.mdを参照してください。

クライアント対応表

環境	根拠
オーナーの Mac 上の Grok Bot / CoS	Codex によるオーケストレーションと Claude Code CLI で、作成 → 完了 → 同一セッションでのフォローアップを実環境で検証済みです。インストール環境固有の連携です。
標準的な stdio MCP クライアント	プロトコルのハンドシェイク、スキーマ、エラー、インストーラー、デモを macOS と Ubuntu で自動テスト済みです。
Codex Desktop macOS / CLI 0.153.4	登録、割り当て、ピン留め、継続性、キュー配信をオーナーがテスト済みです。
Codex Desktop 0.155.0-alpha.9.2	実環境でネイティブメタデータを確認済みです。サイドバーの表示は認定されておらず、レガシーアダプターは無効です。
その他の MCP クライアント	プロトコル互換性が期待されますが、個別の実環境での認定は行っていません。
Claude Code CLI 2.1.269	ローカルでの作成、完了、読み取り、同一セッションでのフォローアップを検証済みです。使い捨てフォルダーで制限付きのファイル書き込みを検証済みです。
Claude Desktop／Claude アカウントの Projects	作成、サイドバーへの登録、ピン留め、ライブセッションの制御は保証していません。保存済みのローカルトランスクリプトは読み取れる場合がありますが、この経路では再開できません。
Windows ランタイム／Linux Desktop 連携	未検証です。macOS Desktop と同等であるとは保証していません。
通常の ChatGPT チャット	対応していません。
ホステッドサービス／Composio cloud	提供しておらず、掲載もしていません。

ネイティブなプロジェクト割り当ては、インストール済みの実験的な App Server API を通じてサポートされます。オプションのバージョン制限付きレガシー Desktop 割り当てアダプターには、バックアップと競合チェックがあります。デフォルトではオフで、引き続き実験的な機能です。

コミュニティ

このプロジェクトは、普遍的な優位性を主張するのではなく、信頼性の高い Chief of Staff の引き継ぎに重点を置いています。他の Codex MCP プロジェクトも、関連する有用なワークフローに対応しています。「最先端」や、すべてのアカウントを制御できること、包括的な自律性を主張するものではありません。

GitHub Discussions でインストールについて質問したり、クライアントの設定例を共有したりできます。再現可能なバグについては、バージョン、状態、エラーの詳細を必ず伏せて Issues に報告してください。非公開のプロンプトや認証情報を全文投稿しないでください。

開発状況を追うには Star を付け、利用するクライアントに合わせるにはフォークしてください。MIT License。