@@ -14,13 +14,13 @@ explicit full-access Codex work when the user asks for it.
1414
1515## Why Use It?
1616
17- - ** Native Claude Code workflow:** Claude gets a small Task-like MCP surface: ` codex_task ` , ` codex_task_group ` , and ` codex_followup ` .
17+ - ** Native Claude Code workflow:** Claude gets a small Task-like MCP surface: ` codex_task ` , ` codex_task_group ` , ` codex_followup ` , and ` codex_wait_any ` .
1818- ** Read-only by default:** Codex starts with ` --sandbox read-only ` and non-interactive approvals.
1919- ** No daemon:** Claude launches the MCP server over stdio for the active session.
2020- ** Fast parallel review:** Claude can launch several independent Codex agents with bounded concurrency.
2121- ** Persistent sessions:** App-server sessions keep Codex context across prompts and support live steering.
2222- ** Codex desktop friendly:** The plugin prefers the Codex binary shipped inside ` Codex.app ` when it exists.
23- - ** Debuggable:** Verbose JSONL logging, diagnostics bundles, progress events, and recovery hints are built in.
23+ - ** Debuggable:** Verbose JSONL logging, diagnostics bundles, progress events, per-session resources, and recovery hints are built in.
2424
2525## Quick Start
2626
@@ -89,8 +89,11 @@ Start a long-running Codex session on this repo, then let me send follow-up prom
8989
9090Claude should use ` codex_task ` for the initial prompt, preserve the returned
9191` session_id ` , and use ` codex_followup ` to continue, steer, wait on, or cancel
92- that same Codex context. For a completed first turn, Claude should set
93- ` keep_session: true ` ; for long first turns, Claude should set ` background: true ` .
92+ that same Codex context. For multiple background sessions, Claude should use
93+ ` codex_wait_any ` to harvest whichever finishes first. Clients can also subscribe
94+ to ` codex://sessions/{session_id} ` for milestone and completion updates. For a
95+ completed first turn, Claude should set ` keep_session: true ` ; for long first
96+ turns, Claude should set ` background: true ` .
9497
9598## Safety Model
9699
@@ -137,8 +140,10 @@ writes and DNS/network remain disabled unless `full_access: true` is set.
137140| Several independent tasks | ` codex_task_group ` |
138141| Persistent context | ` codex_task ` with ` keep_session: true ` , then ` codex_followup ` |
139142| Long-running sessions | ` codex_task ` with ` background: true ` , then ` codex_followup ` |
143+ | First completed background task | ` codex_wait_any ` |
140144| Live steering | ` codex_followup ` with ` mode: "steer" ` |
141145| Stop running work | ` codex_followup ` with ` mode: "cancel" ` |
146+ | Session progress | MCP resource ` codex://sessions/{session_id} ` |
142147| Diagnostics | MCP resources ` codex://status ` , ` codex://doctor ` , ` codex://usage ` |
143148
144149Legacy tools such as ` ask_codex ` , ` run_agent ` , ` run_agents ` , ` start_session ` , and
0 commit comments