Cook

cook

A simple CLI for orchestrating Claude Code, Codex, and OpenCode.

Two ways to get it:

Skill (no CLI) — your agent orchestrates subagents directly:

CLI — standalone tool for terminal or CI:

Requires Node.js 20+ and Claude Code, Codex, or OpenCode.

Docker network

By default, Docker sandbox restricts outbound traffic to only what each agent requires. Configure in .cook/config.json:

allowedHosts adds extra hosts to the whitelist when mode is "restricted".

Commands

Primitives

Work — a prompt string. One agent call.

Loop operators wrap work with iteration:
- xN — N sequential passes
- review — review → gate → iterate loop (up to 3 by default)
- ralph N "" — repeat until a gate says DONE

Composition operators run parallel branches then resolve:
- vN — N identical branches, pick the best
- vs — two different branches, pick the best
- pick, merge, compare — resolvers

Operators compose left to right. Each wraps everything to its left.

Review loop

Rate-limit recovery

When an agent hits a token quota or rate limit, cook automatically waits and retries instead of bailing. A countdown is shown in the TUI. Enabled by default.

Configure in .cook/config.json:

Configuration

Creates COOK.md (project instructions + prompt template) and .cook/config.json: