Run multiple Codex tasks in parallel across workspaces
codex_batchExecute multiple coding tasks in parallel across distinct workspaces, each with its own directory and configuration, with configurable concurrency limits and continue-on-error or fail-fast modes.
Instructions
Fan out N tasks across N cwds (typically git worktrees) with a bounded concurrency limit. Each task uses its own per-cwd lock, so callers must supply distinct cwds. Returns one result entry per input task in input order.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tasks | Yes | Tasks to run in parallel, one per workspace. Each task uses its own cwd (must be unique in the batch). | |
| failFast | No | If true, cancel remaining tasks on the first failure. Default false (continue-on-error). | |
| maxConcurrency | No | Cap on parallel tasks (default 10, hard cap 32). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tasks | Yes | ||
| total | Yes | ||
| failed | Yes | ||
| summary | Yes |