Executors

Configure AI backends to execute tasks.

Codex CLI

Non-interactive execution with sandboxing.

Configuration:

CODEX_ENABLED=true
CODEX_BINARY=codex
CODEX_DEFAULT_MODEL=gpt-4
CODEX_ENABLE_SEARCH=true

Execution:

codex exec \
  --model gpt-4 \
  --sandbox read-only \
  -a untrusted \
  --search \
  "${PROMPT}"

Claude Code

Agent mode with structured output.

Configuration:

CLAUDE_ENABLED=true
CLAUDE_BINARY=claude
CLAUDE_DEFAULT_MODEL=claude-sonnet-4

Custom Executors

Implement the Executor interface:

interface Executor {
  name: string;
  execute(spec: JobSpec, context: ExecutorContext): Promise<Result<ExecutorOutput, string>>;
}

See src/executors/ for examples.