codex_start
Initiate a background codex task and receive an immediate job ID to track progress without blocking or timeout.
Instructions
Start a codex task asynchronously in the background.
Returns a job_id immediately — does not block or timeout. Use codex_poll(job_id) to check progress.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>",
"cwd": "<cwd>"
},
"name": "codex_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | The task description to pass to codex. | |
| cwd | Yes | Absolute path to the working directory for codex. | |
| approval_policy | No | One of 'suggest', 'auto-edit', 'full-auto'. Default: 'suggest'. | suggest |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||