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

Summary

cook is a command-line interface (CLI) and agent skill designed to orchestrate multiple AI code generation models, including Claude Code, Codex, and OpenCode. It targets developers and researchers seeking to streamline complex, iterative AI-assisted software development workflows, enabling structured generation, review, and comparison of code outputs.

How It Works

The tool employs a composable, left-to-right operator model. Users define workflows using simple prompt strings combined with operators like xN for sequential passes, review for iterative human-in-the-loop refinement, vN for parallel execution and best-result selection, and vs for comparing two distinct approaches. This approach allows for sophisticated multi-agent task decomposition and execution, abstracting away the complexities of managing individual LLM calls and retries.

Quick Start & Requirements

Installation is available via npm install -g @let-it-cook/cli or by integrating a "Skill" file for direct use within the Claude agent environment. Key requirements include Node.js 20+ and access tokens for the target AI models (e.g., CLAUDE_CODE_OAUTH_TOKEN).

Highlighted Details

• Rate-Limit Recovery: Automatically handles LLM rate limits and token quotas with configurable retry delays and maximum wait times, preventing workflow interruptions.
• Configuration: cook init generates project configuration files (COOK.md, .cook/config.json) for defining default agents, models, and environment variables.
• Composable Operators: Offers a rich set of operators (xN, review, vN, vs, ralph) for defining intricate AI-driven development processes.

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord, Slack), or project roadmap were present in the provided README snippet.

Licensing & Compatibility

The specific open-source license for this project was not explicitly stated in the provided README content. This lack of clarity may impact commercial use or integration into closed-source projects.

Limitations & Caveats

The tool's functionality is inherently tied to the availability and API access of specific third-party AI models (Claude Code, Codex, OpenCode). Users must ensure compatibility with Node.js 20+. The absence of explicit licensing information requires further investigation before adoption.