clone/codex
1
0
Fork 0
mirror of https://github.com/openai/codex.git synced 2026-04-30 01:16:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add external approval handler support

Browse Source 
Add config-driven external approval handling in core, surface handler failures in the TUI, and share thread labels across core and TUI.

Check in the macOS approval dialog helper under scripts/, document the config path, and fix handler stdin delivery by dropping the child stdin handle after writes so EOF reaches the helper promptly.

Co-authored-by: Codex <noreply@openai.com>
This commit is contained in:
Eugene Brevdo
2026-03-03 18:03:42 -08:00
parent e6773f856c
commit dbaf411b93
17 changed files with 2355 additions and 82 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
docs/config.md
View File

@@ -26,6 +26,28 @@ Codex can run a notification hook when the agent finishes a turn. See the config
When Codex knows which client started the turn, the legacy notify JSON payload also includes a top-level `client` field. The TUI reports `codex-tui`, and the app server reports the `clientInfo.name` value from `initialize`.
## Approval handler
Codex can delegate exec, patch, and MCP elicitation approvals to an external
command via `[approval_handler]` in `config.toml`.
Example:
```toml
[approval_handler]
command = ["python3", "/path/to/codex/scripts/macos_approval_dialog.py"]
timeout_ms = 300000
on_error = "fallback"
```
Codex writes each approval request as JSON to the handler's stdin and expects a
single approval `Op` JSON object on stdout. The request payload includes
`thread_id` and, when available, `thread_label`. `thread_label` is optional and
should be treated as best-effort metadata.
On macOS, this repository includes a native approval helper at
[`scripts/macos_approval_dialog.py`](../scripts/macos_approval_dialog.py).
## JSON Schema
The generated JSON Schema for `config.toml` lives at `codex-rs/core/config.schema.json`.