codebeast

A coding agent for your terminal. Bring your own model: OpenAI, Anthropic, OpenRouter, Gemini, DeepSeek, Groq, Mistral, xAI, Together AI, a local Ollama or LM Studio server, or any OpenAI-compatible endpoint.

codebeast reads and edits your code, runs commands in an OS sandbox, plans larger changes before making them, hands research to sub-agents, reviews diffs, and opens pull requests.

codebeast "add input validation to the signup form"

Install

macOS and Linux (x64 and arm64):

curl -fsSL https://raw.githubusercontent.com/tauqeernasir/codebeast-cli/main/install.sh | bash

This puts codebeast in ~/.local/bin. Make sure that directory is on your PATH. Other options (a pinned version, a different directory, a manual download) are in Getting started.

Quick start

cd your-project
codebeast

The first run opens a setup wizard. Pick a provider, paste your API key, and choose a default model. codebeast finds keys you already exported (OPENAI_API_KEY, ANTHROPIC_API_KEY, …) and local Ollama / LM Studio servers on its own.

Then:

• Type a task and press Enter.
• Press Tab to switch to Plan mode, where the agent investigates and proposes a plan before it changes anything.
• Run /init once per repo. It writes an AGENTS.md with your project's conventions so the agent starts with the right context.
• Press F1 for keyboard shortcuts, or Ctrl+K for every command.

For a single prompt with no UI, pass it as an argument: codebeast -p "explain src/auth".

Documentation

Requirements

• macOS or Linux. Windows is not supported yet.
• An API key for a model provider, or a local model server.
• On Linux, the shell sandbox needs bubblewrap and socat (sudo apt-get install bubblewrap socat).

Support

Report bugs and ask questions in Issues. Include the output of codebeast --version, your OS, and the provider you use. Never paste an API key.

License

codebeast is free to download and use under the codebeast terms. The source code is not public.