                              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 that runs tasks in natural language.
One binary. No runtime. Works with any LLM provider.

Quick Start · Usage · Providers · Safety · Configuration

--- ## Why cook? Most AI coding tools lock you into an editor, a specific model, or a subscription. **cook** is different: - **Shell-native** — lives in your terminal, works with pipes, scripts, and cron jobs - **Model-agnostic** — swap between OpenAI, Anthropic, Google, Groq, or Vercel AI Gateway with a flag - **Single binary** — compiles to a standalone executable with zero runtime dependencies - **Safe by default** — every file write and destructive command requires your approval - **Extensible** — bring your own system prompts, command aliases, and agent configurations ```bash # just talk to it cook find all TODO comments in this repo and summarize them # pipe data in cat server.log | cook "find the root cause of the 502 errors" # use command aliases cook /create-pr ``` --- ## Table of Contents - [Quick Start](#quick-start) - [Usage](#usage) - [Natural Language](#natural-language) - [Piped Input](#piped-input) - [Command Aliases](#command-aliases) - [Agents](#agents) - [Output Modes](#output-modes) - [Raw Terminal Mode](#raw-terminal-mode) - [Providers & Models](#providers--models) - [Safety](#safety) - [Configuration](#configuration) - [Config Precedence](#config-precedence) - [Example Config](#example-config) - [System Prompt Composition](#sy