v1.2.8 — Now on npm

The AI Coding Agent
that Works for You

51+ native tools, RAG-based code intelligence, 9 beautiful themes, and support for 45+ AI providers. Your terminal deserves better.

Install Now Quick Start

51+

Native Tools

10

Themes

45+

AI Providers

~ beast --defaults

$ beast --defaults

    🐉 Beast CLI
    Smart defaults: ChatGPT Plus (OAuth)

────────────────────────────
Provider:  ChatGPT Plus
Model:    gpt-5.2-codex
Status:    Ready (Plus active)
────────────────────────────

❯ Build me a REST API

◈ Using GPT-5.2-codex...
✓ Generated complete REST API with TypeScript

Features

Everything you need to build faster

Built for developers who want powerful AI assistance without leaving the terminal

🧠

RAG Code Intelligence

TF-IDF + RAG-based retrieval understands your codebase context for smarter suggestions.

🔧

51+ Native Tools

File operations, web search, GitHub integration, code execution, and 12 engineering tools.

🎨

10 Themes

Catppuccin, Dracula, Nord, Claude, Tokyo Night, Gruvbox, Monokai, and more. Pick your vibe.

🤖

45+ AI Providers

Claude, GPT, Gemini, Groq, Ollama, LM Studio, Azure, AWS Bedrock, and more.

💾

Smart Context

Auto-compact at 95%, session persistence, memory checkpoints. Never lose context.

💳

ChatGPT Plus/Pro

Use your existing $20/mo subscription via OAuth — no API billing needed.

🔒

Permission System

Auto-approve safe commands, banned list protection, session-based permissions.

Installation

Get started in seconds

Works with Node.js, Bun, or our one-line installer

N

npm

npm install -g @simpletoolsindia/beast-cli

B

Bun

bun add -g @simpletoolsindia/beast-cli

⚡

One-liner

curl -fsSL ... | bash

Requirements

Node.js 18+ Bun 1.0+ macOS / Linux / Windows

Usage

Start coding now

Simple commands, powerful results

▶

Start Beast CLI

beast

Auto-detects your configured API keys and starts the REPL.

⚡

Choose Provider & Model

beast --provider ollama --model llama3.2

beast --provider anthropic --model claude-sonnet-4-20250514

beast --provider openai --model gpt-4o

⌨️

REPL Commands

Core Commands

/help

Show all available commands

/exit

Exit Beast CLI (also: exit, quit)

/clear

Clear chat history and start fresh

/tools

List all 51+ native tools available

Model Management

/models

List all available models for current provider

/model

Interactively switch to a different model

/model <name>

Switch to model by name or number

Provider Management

/provider

Interactively switch to a different provider

/provider <name>

Switch directly to a provider by name

CLI Flags

--provider <name> Set provider (anthropic, openai, ollama, etc.)

--model <name> Set model (claude-sonnet-4-20250514, gpt-4o, etc.)

--theme <name> Change color theme (catppuccin-mocha, dracula, claude, etc.)

--defaults Auto-select best available provider (recommended for beginners)

--compact Manually trigger context compaction

--help Show help information

--version Show version number

🧠

Engineering Intelligence

12 specialized tools for code analysis and engineering tasks:

engi_task_classify

Classify task type

engi_repo_scope_find

Find relevant files

engi_flow_summarize

Explain code flow

engi_bug_trace_compact

Trace bug causes

engi_memory_checkpoint

Save task state

engi_impact_analyze

Analyze blast radius

Configuration

Set up your environment

Environment Variables

ANTHROPIC_API_KEY

For Claude models

OPENAI_API_KEY

For GPT models

GEMINI_API_KEY

For Gemini models

GROQ_API_KEY

For Groq models

Config File

Create ~/.beast-cli.yml:

provider: anthropic
model: claude-sonnet-4-20250514
theme: catppuccin-mocha
temperature: 0.7
maxTokens: 16384
autoCompact: true

New Feature

Use ChatGPT Plus
in your terminal

No API key needed — just sign in with your existing $20/month subscription. Your billing, your models.

✓ Free with ChatGPT Plus/Pro subscription

✓ GPT-5.2, GPT-5.1, o3, o4-mini models

✓ OAuth browser login (secure PKCE)

✓ Tokens auto-refresh and persist

beast --defaults

Recommended for beginners — auto-selects best option

beast --provider codex --model gpt-5.2-codex

Direct ChatGPT Plus with latest Codex model

/login

Re-authenticate ChatGPT Plus in REPL

/logout

Clear ChatGPT authentication

Providers

Use any model

45+ providers with OpenAI-compatible API support

A

Anthropic

Claude models

O

OpenAI

GPT-5, O-series models

C

ChatGPT Plus

OAuth (Free with Plus)

G

Google

Gemini models

G

Groq

Llama, Qwen models

O

Ollama

Local models

L

LM Studio

Local models

A

Azure

OpenAI on Azure

A

AWS Bedrock

Claude on AWS

O

OpenRouter

Aggregated models

And 35+ more providers...

FAQ

Got questions?

"beast: command not found" after install

Add npm global bin to your PATH:

export PATH="$HOME/.npm-global/bin:$PATH"

Add to ~/.bashrc or ~/.zshrc

How to use ChatGPT Plus (free with subscription)?

1. Run with smart defaults:

beast --defaults

2. Select ChatGPT Plus provider (option 3)

3. Browser opens for OAuth login — sign in with your ChatGPT account

That's it! Tokens auto-save and refresh. Use /login to re-authenticate or /logout to clear.

How to use local models (Ollama)?

1. Install: brew install ollama

2. Start: ollama serve

3. Pull: ollama pull llama3.2

4. Run: beast --provider ollama --model llama3.2

Context window limit errors

Beast auto-compacts at 95% usage. Manual trigger:

beast --compact

Or type /compact in REPL.

How to change themes?

Themes: catppuccin-mocha, dracula, nord, tokyonight, gruvbox, monokai, one-dark

beast --theme dracula

Permission denied for file operations

Type y to allow or a for session-wide approval.

Bypass: BEAST_MODE=bypass beast

Uninstall

npm uninstall -g @simpletoolsindia/beast-cli

Or with the installer:

curl -fsSL ... | bash -s -- --uninstall

The AI Coding Agent that Works for You