背景
現状 autoforge のハーネスモードは Claude Code のサブスクリプション経由で動作する前提になっており、以下が Claude Code 中心になっている:
README.md:126 — 「autoforge runs within Claude Code's subscription」
CLAUDE.md — 推論層を Claude Code に固定する説明
autoforge/harness/solve.py — Next steps for Claude Code: と明示的に Claude Code 向けにレジューム手順を出力
autoforge/cli.py:45 — goals モードのデフォルトバックエンドが claude
autoforge/harness/fix.py:16,187 — AGENTS.md / CLAUDE.md の両方を見るが、生成ドキュメントは Claude Code ユーザーを想定
一方、autoforge/harness/agent_loop.py には既に codex バックエンド (codex exec) が存在する。つまり 実行レイヤは半分揃っているが、ドキュメント・セットアップ・ユーザ体験が Claude Code 前提になっている 状態。
ユーザが Claude Code ではなく Codex app もしくは Codex CLI を主ハーネスとして使う場合でも、autoforge の価値(SDLC パイプライン、SWE-bench スタック、ACI ツール群)を得られるようにしたい。
ゴール
Claude Code を入れていないユーザが Codex app または Codex CLI から autoforge を一級市民として使える ようにする。
具体的には:
- Codex CLI (
codex exec) を推論層として、autoforge loop --mode goals --backend codex が Claude Code と同等の完成度で動く
- Codex app (Web/Desktop) のチャットセッションから
autoforge-tools サブコマンドを呼び出すと、Claude Code で得られるのと同じ観察可能性(行番号付き view / lint 検証付き edit / SWE-bench パッチ保存)が得られる
- ドキュメントが「Claude Code OR Codex」のいずれからでも開始できる書き方になっている
タスク分解
A. ドキュメント(Codex パス)
B. CLI / ランタイム
C. Codex app サポート(チャット運用)
D. 検証
非ゴール
- 独自 Codex SDK ラッパーの実装(
codex exec シェル越し呼び出しで足りるはず)
- pipeline モード(
--mode pipeline)の api バックエンド撤廃。pipeline は ANTHROPIC_API_KEY 必須のままでよい。本 issue は goals モードとハーネスツール層 が対象
参考
- 既存の codex バックエンド実装:
autoforge/harness/agent_loop.py:92-101, BACKENDS dict :110-114
- 関連既存機能:
fix.py は AGENTS.md を既に認識するが、その中身を Codex 用に充実させる作業は未着手
- 類似 issue: なし(2026-04-22 時点で
gh issue list --search codex が空)
背景
現状 autoforge のハーネスモードは Claude Code のサブスクリプション経由で動作する前提になっており、以下が Claude Code 中心になっている:
README.md:126— 「autoforge runs within Claude Code's subscription」CLAUDE.md— 推論層を Claude Code に固定する説明autoforge/harness/solve.py—Next steps for Claude Code:と明示的に Claude Code 向けにレジューム手順を出力autoforge/cli.py:45—goalsモードのデフォルトバックエンドがclaudeautoforge/harness/fix.py:16,187—AGENTS.md/CLAUDE.mdの両方を見るが、生成ドキュメントは Claude Code ユーザーを想定一方、
autoforge/harness/agent_loop.pyには既にcodexバックエンド (codex exec) が存在する。つまり 実行レイヤは半分揃っているが、ドキュメント・セットアップ・ユーザ体験が Claude Code 前提になっている 状態。ユーザが Claude Code ではなく Codex app もしくは Codex CLI を主ハーネスとして使う場合でも、autoforge の価値(SDLC パイプライン、SWE-bench スタック、ACI ツール群)を得られるようにしたい。
ゴール
Claude Code を入れていないユーザが Codex app または Codex CLI から autoforge を一級市民として使える ようにする。
具体的には:
codex exec) を推論層として、autoforge loop --mode goals --backend codexが Claude Code と同等の完成度で動くautoforge-toolsサブコマンドを呼び出すと、Claude Code で得られるのと同じ観察可能性(行番号付き view / lint 検証付き edit / SWE-bench パッチ保存)が得られるタスク分解
A. ドキュメント(Codex パス)
README.mdの「Harness mode」セクションを Claude Code と Codex の両対応 として書き換えるclaude -p例codex exec例AGENTS.mdを新規追加(Codex 向けのブリーフィング、中身はCLAUDE.mdと同等のハーネス手順)。既にfix.pyは AGENTS.md を検索対象にしているので整合が取れるdocs/codex-quickstart.md新設: Codex CLI / Codex app それぞれで autoforge を初回実行するまでの手順B. CLI / ランタイム
autoforge/harness/solve.py:81の"Next steps for Claude Code:"をバックエンド非依存の文言に変更(例:"Next steps for your agent:")autoforge/cli.py:254のgoalsデフォルトをclaude固定から、PATH 上の CLI を自動検出(claude>codex> 明示指定必須)する優先順位ベースに変更。--backend未指定で Claude Code が無い環境では Codex にフォールバックするautoforge/harness/agent_loop.pyの codex 引数組み立てを最新 Codex CLI 仕様に追従(--full-auto/--dangerously-bypass-approvals-and-sandboxのフラグ名・互換性を再確認)setup.shに Codex CLI 検出ブランチを追加(Claude Code が無ければ Codex をチェック、どちらも無ければ案内)C. Codex app サポート(チャット運用)
AGENTS.mdに Codex app のチャット内で貼り付けて使える 起動プロンプト・テンプレ を同梱autoforge-toolsが Codex app の制限(ファイルアクセス / シェル権限モデル)下でも動く場合のモード確認。動かない機能があればdocs/codex-quickstart.mdに limitations として明記D. 検証
tests/にagent_loop._argv_codexのスナップショット系テストを追加(現状テスト有無を要確認)codexCLI がインストールされた環境でautoforge loop --mode goals --backend codex --dry-runが成功することを確認非ゴール
codex execシェル越し呼び出しで足りるはず)--mode pipeline)のapiバックエンド撤廃。pipeline はANTHROPIC_API_KEY必須のままでよい。本 issue は goals モードとハーネスツール層 が対象参考
autoforge/harness/agent_loop.py:92-101,BACKENDSdict:110-114fix.pyはAGENTS.mdを既に認識するが、その中身を Codex 用に充実させる作業は未着手gh issue list --search codexが空)