Quickstart

Launch bwn in a repo and describe a task. The agent reads files, edits them behind a permission gate, runs commands, and iterates until tests pass.

Interactive session

bwn                         # full-screen TUI
> fix the failing pagination test

Headless

bwn run "fix the failing test"       # agentic BUILD loop, no TUI
bwn plan "migrate the config loader" # decompose → approve → execute
bwn brainstorm "how should auth work?"
bwn --json run "…"                   # machine-readable event stream

Modes

Mode	What it does
PLAN	Decomposes the task into steps you approve or edit, then executes.
BUILD	The agentic ReAct loop — read, edit, run, iterate.
BRAINSTORM	Free-form chat with read-only tools.

Shift+Tab cycles modes. The active mode shows as a colored badge in the banner.

While the agent works

Keep typing — messages queue and auto-send on the next turn.
Esc interrupts the agent (a typed draft is cleared first).
Ctrl+Q edits the queued message, Ctrl+X removes it.