Skip to content

Commit 92297ca

Browse files
xuiocodex
andcommitted
Add Codex session notifications
Co-Authored-By: OpenAI Codex <noreply@openai.com>
1 parent 6f82c68 commit 92297ca

13 files changed

Lines changed: 2023 additions & 53 deletions

README.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -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

9090
Claude 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

144149
Legacy tools such as `ask_codex`, `run_agent`, `run_agents`, `start_session`, and

0 commit comments

Comments
 (0)