danielvo-codex-bridge

danielvo-codex-bridge

danielvo-codex-bridge は、Claude Code からローカルの Codex CLI worker を呼び出すための個人用ブリッジです。

最初の対応範囲は次の流れです。

Claude Code -> 複数の Codex CLI worker -> 結果を Claude Code に戻す

レビュー、調査、見積もり、仕様作成、タスク分解など、「もう一つのモデル視点」が欲しい場面で使うことを想定しています。

できること

• 1 つの Codex worker を danielvo-codex で実行する
• 複数の Codex worker を danielvo-codex-fanout で並列実行する
• Codex のレビュー機能を danielvo-codex-review で呼び出す
• worker ごとの出力を .agent-runs/<run-id>/ に保存する
• Claude Code plugin 化しやすい skills/ 構成を持つ

インストール

Codex CLI が必要です。

brew install codex   # 既に入っていれば不要
codex --version

Claude Code plugin として使う(推奨)

このリポジトリ自体が plugin marketplace 兼 plugin として動作します。

# このリポジトリを clone した directory を指定する
claude plugin marketplace add <path/to/danielvo-codex-bridge>
claude plugin install danielvo-codex-bridge@danielvo-codex-bridge

skill (codex-research / codex-estimate / codex-spec / codex-review / codex-breakdown / codex-implement / codex-swarm) が Claude Code から呼び出せるようになります。bin スクリプトは ${CLAUDE_PLUGIN_ROOT}/bin/ 経由で参照されるため、PATH 設定は不要です。

シェルから直接使う

このリポジトリを clone したあと、bin/ を PATH に追加してください。

export PATH="$PWD/bin:$PATH"

基本的な使い方

1 つの worker を read-only で実行します。

danielvo-codex \
  --mode research \
  --sandbox read-only \
  --prompt "認証まわりの実装方針を調査して、リスクと選択肢をまとめて"

複数 worker を並列実行します。

danielvo-codex-fanout \
  --task "認証機能の実装方針をレビューして" \
  --workers research,estimate,review,breakdown

未コミット変更をレビューします。

danielvo-codex-review --uncommitted

詳しい使い方は docs/usage.md を見てください。

安全方針

初期状態では read-only 実行を優先します。書き込みを許す場合は、対象を明示し、できれば別 git worktree で実行してください。

詳細は docs/safety.md にまとめています。