beast

Terminal coding agent

Let AI move fast.
Keep your hands on the wheel.

Beast brings agentic development under your control, giving language models a tool-driven way to understand your project, make targeted changes, and run approved commands.

Install Beast
01 single binary 02 openai-compatible 03 Linux + WSL
~/projects/beast ready
beast v0.3.3
> inspect the auth flow and add tests
PLAN MODE
01Reading project structuredone
02Tracing authentication pathsdone
03Preparing implementation plan...
>
Tab toggle modeplan300K ctx
Read first. Change second.
Built for deliberate development
Project-scoped sessions Sandboxed Bash execution Confirmation-gated commands Provider-only network access Streaming responses

The useful middle ground

More than chat.
Less than autopilot.

Beast puts the project and the model in the same loop, without handing over the keys. Every action is visible, scoped, and shaped for software work.

01 / clarity

Understands your project first

Beast gets familiar with your project, finds what matters, and makes focused updates with care. For larger tasks, the main agent can break work into subtasks and delegate them to subagents.

Find what mattersSee the bigger pictureRead before changingMake focused updatesDelegate focused subtasks

02 / control

Safe, local execution

Beast runs Bash commands in a sandboxed environment on your machine. It does not connect to any server or send your data anywhere other than your chosen LLM provider. Commands still pause for confirmation, so you stay in control of what runs.

03 / continuity

Long-running context

Resume project-scoped sessions, track live token usage, and compact context when work gets deep.

04 / compatibility

Bring the model you already use

Connect to OpenAI, OpenRouter, Groq, Mistral, Ollama, Google-compatible endpoints, or your own base URL.

OpenAIOpenRouterGroqMistralOllamaCustom endpoints

A better operating rhythm

One harness.
Two intentional modes.

01Plan

Explore without risk

Give the model read-only access to inspect the codebase and produce an implementation plan without modifying anything.

> map the project
02Build

Make the change

Switch modes when the plan is clear. Beast exposes editing and execution tools, one deliberate action at a time.

> implement the plan
03Verify

Review what happened

Inspect the edits, approve commands as they appear, and keep the conversation available for the next iteration.

> run the tests
TAB Toggle between Plan and Build at any time.

Install Beast

Get started in
a few commands.

Download Beast and start coding on Linux or through Windows Subsystem for Linux (WSL).

Before you start

Make sure bwrap (bubblewrap) and rg (ripgrep) are installed before running Beast.

bwrap --version rg --version
Download binary ->
Linux / WSL installation ready to run
01mkdir -p ~/.local/bin
02curl -fsSL https://beast-agent.com/beast -o ~/.local/bin/beast
03chmod +x ~/.local/bin/beast
04export PATH="$HOME/.local/bin:$PATH"
05beast