🐉

# Beast CLI

AI Coding Agent with 45+ Providers • Local & Cloud Models • Easy Setup

✓
Step 1: Prerequisites
Install Bun and Ollama
▼
terminal
$ # Install Bun (package manager)
curl -fsSL https://bun.sh/install | bash
$ # Install Ollama (local AI models)
brew install ollama
✓ Prerequisites installed
Note: Ollama runs AI models locally on your machine. No internet required for local models!

- ✓ Bun installed
- ✓ Ollama installed

✓
Step 2: Clone Repository
Get Beast CLI from GitHub
▼
terminal
$ git clone https://github.com/simpletoolsindia/code-cli.git
Cloning into 'code-cli'...
remote: Enumerating objects: 100%
Receiving objects: 100%
$ cd code-cli
✓ Repository cloned
✓
Step 3: Install Dependencies
Install npm packages
▼
terminal
$ bun install
bun install v1.x.x
✓ installed 12 packages
✓ Dependencies installed
✓
Step 4: Start Ollama Service
Run Ollama in background
▼
terminal
$ # Start Ollama in background
ollama serve &
Ollama is running at http://localhost:11434
$ # Download a model (first time only)
ollama pull llama3.1:8b
✓ Ollama running with llama3.1:8b
Tip: Models are downloaded once and cached. Choose small models (1-8B) for faster responses.
5
Step 5: Run Beast CLI
Start using the AI coding agent
▼
beast - AI Coding Agent
$ bun run src/index.ts
┌─────────────────────────────────────┐
│ 🐉 Beast │ AI Coding Agent │
└─────────────────────────────────────┘
Providers: ● OLL (online) ○ LMS ○ CLA ○ GPT
Model: qwen2.5-coder:32b [WRITE]
❯ Create a React login form
🤖 I'll create a React login form with email/password...
✓ Created: src/components/LoginForm.tsx
✓ Created: src/styles/login.css
✓ Task completed in 3.2s

## 🎬 Live Demo

Live Demo - @simpletoolsindia/beast-cli
$ npm install -g @simpletoolsindia/beast-cli
added 12 packages in 2s
$ beast --test
🐉 Beast CLI - MCP Server Integration Test
════════════════════════════════════════════════════════════
📦 Testing extra_skills_mcp_tools Integration
MCP Server: localhost:7710
⏳ Initializing MCP connection...
✅ Connected: mcp-server-unified
✅ Found 64 MCP tools
📦 Testing Ollama (Local)
✅ Ollama accessible: 13 models
• qwen2.5-coder:32b (19.9 GB)
• gemma4:31b (19.9 GB)
• llama3.1:8b (4.9 GB)
📦 Testing LM Studio (Local)
✅ LM Studio accessible: 5 models
════════════════════════════════════════════════════════════
📊 INTEGRATION SUMMARY
extra_skills_mcp_tools: ✅ PASS
Ollama (Local): ✅ PASS
LM Studio (Local): ✅ PASS
🎉 3/3 integrations working!

## ✨ Features

🦙

### Local Models

Run AI locally with Ollama, LM Studio, Jan.ai

☁️

### Cloud Providers

Claude, GPT, DeepSeek, Gemini, and 40+ more

🔒

### Secure

Landlock sandbox, pattern detection

🚀

### Fast

80% token reduction with MCP tools

## ⚡ Quick Commands

# Install from npm (Recommended)
npm install -g @simpletoolsindia/beast-cli
# Run Beast CLI
beast
# Or use directly with npx
npx @simpletoolsindia/beast-cli
# Start Ollama (for local AI)
ollama serve
# Run integration tests
bun test-mcp-integration.ts

Built with ❤️ by SimpleTools

GitHub • Releases