Brew your code with AI.

A terminal AI agent that reads, explores, edits, and runs your code, with permission modes that keep you in control.

codebrew chat

Built for real terminal work.

CodeBrew wraps the Claude Agent SDK's agent loop in an interface made for developers who live in the command line.

Streaming agent loop

Assistant text, tool calls, and results print live as the agent works, whether it's a one-off prompt or a long interactive session.

Conversation memory

Interactive chat sessions remember every turn, so follow-ups build on what came before.

Live tool visibility

Every Read, Edit, Write, and Bash call streams to your terminal as it happens.

Cost & turn guardrails

Sessions cap at 25 turns and $1.00 by default, with a running cost line each turn.

Polished terminal UI

A colored, spinner-driven interface that renders each turn cleanly, verbose or not.

You decide how much freedom it gets.

Three permission modes control what CodeBrew can touch. Switch between them mid-session with /mode.

ask

Just look and tell me

Can it edit files?: Edit files
Can it run commands?: Run commands

Best for quick answers & exploration.

plan

Think it through, propose a plan

Can it edit files?: Edit files
Can it run commands?: Run commands

Best for reviewing an approach before acting.

agent

Go ahead and do it

Can it edit files?: Edit files
Can it run commands?: Run commands

Best for getting work done.

Two ways to talk to it.

Everything branches on one thing: whether the agent gets a single prompt, or a live conversation it can remember.

codebrew talk "explain this project"

Single-shot

One prompt in, one agent run, then it exits. No memory between runs.

1Prompt sent as a string
2Agent runs once
3Result printed, session ends

codebrew chat --mode agent

Interactive chat

A persistent session that remembers every turn until you exit.

1Prompt streamed turn by turn
2Session stays open, remembers context
3Switch modes live with /mode, exit with /exit

Remembers context across turns

Three commands to your first session.

Requires Node.js 18 or higher and an Anthropic API key.

Full installation guide

Install

npm install -g @buildwithatul/codebrew

Set your API key

export ANTHROPIC_API_KEY=your_key

Start

codebrew wakeup

Questions, answered.

The things people usually ask before their first session. Everything else lives in the docs.