cook — portable terminal AI agent

2 min read Original article ↗ 
                              oooo
                              `888
 .ooooo.   .ooooo.   .ooooo.   888  oooo
d88' `"Y8 d88' `88b d88' `88b  888 .8P'
888       888   888 888   888  888888.
888   .o8 888   888 888   888  888 `88b.
`Y8bod8P' `Y8bod8P' `Y8bod8P' o888o o888o

A portable terminal AI agent.

One binary. No runtime. Works with any LLM provider.

copied $ curl -fsSL https://getcook.dev/install.sh | sh

why cook

Your terminal, supercharged.

Most AI tools lock you into an editor or a subscription. cook lives in your shell and works with pipes, scripts, and cron.

01

Shell-native

Pipes in, stdout out. Works with your existing scripts and workflows.

02

Model-agnostic

Swap between OpenAI, Anthropic, Google, Groq, or Vercel AI Gateway with a flag.

03

Single binary

Compiles to a standalone executable. No Node, no Python, no runtime.

04

Safe by default

Every file write and destructive command requires your explicit approval.

05

Command aliases

Save prompts as .md files. Run them with cook /deploy. Compatible with Cursor & Claude commands.

06

Multi-agent

Define multiple agents with different models. Switch per run with --agent.

usage

Just type what you want.

$ cook find all TODO comments and summarize them


$ cat server.log | cook "find the root cause of the 502 errors"


$ cook /create-pr


$ cook --agent fast "what does main.ts export?"


$ cook --dry-run "refactor the auth module"


$ cook --raw "find my public IP"

providers

Works with what you have.

Set an API key and cook picks the right model automatically. No config file required.

Provider Env Variable Default Model
Vercel AI Gateway AI_GATEWAY_API_KEY gemini-3-flash-preview
OpenAI OPENAI_API_KEY gpt-5.2
Anthropic ANTHROPIC_API_KEY claude-sonnet-4-6
Google GOOGLE_GENERATIVE_AI_API_KEY gemini-3-flash-preview
Groq GROQ_API_KEY kimi-k2-instruct

safety

You stay in control.

  • ✓ File writes and destructive commands require confirmation
  • ✓ Smart mutation detection — model-classified, not regex
  • ✓ File access scoped to current directory by default
  • ✓ --dry-run to preview everything before it runs
  • ✓ Deny any action and give guidance in plain text
  • ✓ Full session logging with visual HTML reports

Get started in 10 seconds.

$ curl -fsSL https://getcook.dev/install.sh | sh


$ export ANTHROPIC_API_KEY="sk-..."


$ cook "explain what this project does"

View on GitHub