codex_delegate_async
Delegate a coding task to run in the background, returning a job ID for later polling. The result is a reviewable diff that is not applied to your repository.
Instructions
Delegate a coding task to Codex in the background and get a job_id back
immediately (does not block on the run).
Same propose-tier behavior as codex_delegate — Codex works in a throwaway git
worktree and the result carries a reviewable diff that is NOT applied — but
it runs detached. Starting a job commits to spend (it runs to completion or its
wall-clock deadline even if you never poll). Poll with codex_job_status, read
with codex_job_result, delete after reading with codex_job_consume_result,
or stop with codex_job_cancel. Requires a git repo with at least one commit;
pass workspace_root (absolute).
NO NETWORK: like codex_delegate, this runs under workspace-write, which blocks
network egress for commands Codex RUNS in the sandbox — the task must be
self-contained (no push/fetch/gh/curl/publish/dependency install; those fail with
a DNS/host-resolution error in the sandbox). This does NOT mean nothing leaves the
machine: the Codex model call still sends your task (raw) to OpenAI and lets Codex
read tracked files in the worktree and send their content. Secret redaction is
best-effort and does not cover your task or files Codex reads itself.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task | Yes | The coding task for Codex to implement inside a throwaway git worktree; the resulting diff is returned for review, not applied to your tree. | |
| model | No | Override the Codex model slug for this call; defaults to the server/Codex default when unset. | |
| isolation | No | Codex config isolation: 'inherit' (default), 'ignore-config', or 'ignore-rules'. | |
| workspace_root | No | Absolute path to the target repository root. Pass it (or rely on an MCP root) so the call targets the intended repo; otherwise it falls back to the server's own cwd and meta.workspace_warning is set. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes |