codex_agent
Launch a persistent Codex interactive agent in a background terminal for coding, review, and research via conversation. Set model, reasoning effort, and write scope; get async completion.
Instructions
【旧互換alias。新規連携は agent_launch(harness=codex-cli)】Codexの対話エージェント TUI を永続端末に起動する。実装・レビュー・調査を対話で回す。通常CLIと同じHOME・cwd・project/user/local設定・MCP・plugin・skill・permission/trustを共有する。aitermは完了相関stateだけをlaunch単位で所有する。起動されたagentにはsub-agent自己認識、親session、delegation depth/lineage、delegation_allowed=trueを注入し、必要な追加委譲は許可する。委譲契約を使う完全な呼び出し例: codex_agent({"prompt":"<依頼>","model":"gpt-5.6-sol","reasoning_effort":"high","cwd":"/absolute/path/to/repo","write_scope":"read-only"})。turn は pty_send で送る（自動で非ブロック dispatch になる）。起動して投げたら投げっぱなしでよい＝親はここで待たない。完了通知は起動応答またはpty_send dispatch receiptの wait_processを、親のターンを塞がない別プロセスAPIへexecutable／argsの境界を保ったまま渡して受ける（PowerShell 7のStart-Processはwindows_start_process_argument_listを使う）（exit 0=done / 3=timeout（既定600秒・未完了） / 4=closed。receiptのoutcomeが正で、done以外は未完了。ポーリング不要・foreground実行はしない）。wait_commandは人間向け互換表示。結果回収は pty_read(agent_transcript:true)。model / reasoning_effort を引数で指定可（省略時は端末 config／CLI 既定を継承。実効値は起動応答に明示）。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | 作業ディレクトリ（対象リポのルート等・任意） | |
| model | No | 起動モデル（例: gpt-5.6-sol / gpt-5.6-terra / gpt-5.6-luna）。省略時は端末 config／CLI 既定を継承（端末側のピンがそのまま効く。実効値は起動応答に明示される） | |
| prompt | No | 起動時に渡す初手プロンプト（任意）。送信後は待たずに即返る | |
| env_vars | No | 起動したagentへ現在のMCP processから継承する環境変数名。値はtool引数へ渡さない | |
| write_scope | No | 能力宣言。read-only、または書込みを許可するパスの説明文字列。対応harnessのread-onlyはCLI標準のread-only面で実効禁止する | |
| session_name | No | セッション名（省略で自動採番） | |
| reasoning_effort | No | reasoning effort（思考レベル）。low/medium/high/xhigh/max/ultra（CLI／model 版依存）。ultra は max 推論＋proactive 自動委譲 ON＝使用量急増注意（明示要求時のみ）。省略時は端末 config／CLI 既定。 | |
| throughline_source_session | No | 同一端末のThroughline sessionから所有権を変えずに記憶を読み、promptのmissionより前へ注入する | |
| throughline_supplement_file | No | Throughline 0.10.8以降へそのまま渡すproject束縛済み長期記憶・知識の補足JSON path |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| schema | Yes | ||
| harness | Yes | ||
| provider | Yes | ||
| session_id | Yes | ||
| write_scope | No | ||
| event_cursor | Yes | ||
| wait_command | Yes | ||
| wait_process | Yes | ||
| submit_residue | Yes | ||
| managed_completion | Yes | 後方互換field。trueはaiterm完了相関が有効という意味で、project/user環境の隔離を意味しない | |
| write_scope_enforcement | No |