cook — portable terminal AI agent

                              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 # click to copy

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.

Shell-native

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

Model-agnostic

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

Single binary

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

Safe by default

Every file write and destructive command requires your explicit approval.

Command aliases

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

Multi-agent

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

usage

Just type what you want.

# natural language — quotes optional
$ cook find all TODO comments and summarize them

# pipe data in
$ cat server.log | cook "find the root cause of the 502 errors"

# command aliases
$ cook /create-pr

# pick a model
$ cook --agent fast "what does main.ts export?"

# preview without executing
$ cook --dry-run "refactor the auth module"

# raw output, no summarization
$ 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.

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

# set any provider key
$ export ANTHROPIC_API_KEY="sk-..."

# go
$ cook "explain what this project does"

View on GitHub