Runs OpenAI's Codex CLI non-interactively (codex exec) to execute a coding task and returns its final message.

Args:

• prompt (string, required): task instructions for Codex

• cwd (string, optional): absolute working directory for the task

• model (string, optional): model override (e.g. "gpt-5.6-luna")

• timeout_seconds (number, optional, default 600): kill the process after this many seconds

• auto_approve (boolean, optional, default false): bypass Codex's shell/edit approval prompts. Without this, tasks that need to run a command or edit a file will fail immediately since there is no terminal to approve from.

Returns structured JSON: { success, final_message, exit_code, timed_out, stderr? }.

Error Handling:

• success=false with a non-zero exit_code and stderr populated means Codex reported an error (e.g. auth, invalid model, sandbox denial)

• timed_out=true means the task exceeded timeout_seconds and was killed

Runs Claude Code non-interactively (claude -p --output-format json) to execute a task and returns its final message.

Args:

• prompt (string, required): task instructions for Claude

• cwd (string, optional): absolute working directory for the task

• model (string, optional): model override (e.g. "claude-opus-4-8")

• timeout_seconds (number, optional, default 600): kill the process after this many seconds

• auto_approve (boolean, optional, default false): bypass Claude's tool-permission prompts (--dangerously-skip-permissions). Without this, tasks that need to use tools will fail immediately since there is no terminal to approve from.

Returns structured JSON: { success, final_message, exit_code, timed_out, stderr? }.

Error Handling:

• success=false with a non-zero exit_code and stderr populated means the CLI reported an error (e.g. auth, invalid model)

• timed_out=true means the task exceeded timeout_seconds and was killed

Runs the Antigravity CLI non-interactively (agy -p) to execute a task and returns its response.

Args:

• prompt (string, required): task instructions for the agy agent

• cwd (string, optional): absolute working directory for the task

• model (string, optional): model override

• timeout_seconds (number, optional, default 600): kill the process after this many seconds

• auto_approve (boolean, optional, default false): bypass agy's tool-permission prompts (--dangerously-skip-permissions). Without this, tasks that need to use tools will fail immediately since there is no terminal to approve from.

Returns structured JSON: { success, final_message, exit_code, timed_out, stderr? }. Note: agy has no JSON output mode, so final_message is the raw trimmed stdout.

Error Handling:

• success=false with a non-zero exit_code and stderr populated means the CLI reported an error

• timed_out=true means the task exceeded timeout_seconds and was killed