GitHub - jgarzik/brainpro: Agentic bot and coding

1 min read Original article ↗

brainpro

A local agentic coding assistant. Vendor-neutral, multi-model routing—send coding to Claude, planning to Qwen, exploration to GPT.

Two Paths

Path Entry Point Persona Use Case
Direct yo CLI MrCode (7 tools) Local dev, quick tasks
Gateway brainpro-gateway + brainpro-agent MrBot (12+ tools) Remote access, daemon mode, Docker

Features

  • Local execution - Runs on your machine, project-scoped file access
  • Multi-backend LLM - Venice, OpenAI, Anthropic, Ollama, custom endpoints
  • Model routing - Auto-select models by task type (planning/coding/exploration)
  • Built-in tools - Read, Write, Edit, Grep, Glob, Bash, Search
  • MCP integration - External tool servers via Model Context Protocol
  • Subagents - Delegate to specialized agents with restricted tools
  • Skill packs - Reusable instruction sets with tool restrictions
  • Workspace memory - Persistent context via BOOTSTRAP.md, MEMORY.md, WORKING.md
  • Permission system - Granular allow/ask/deny rules
  • Session transcripts - JSONL audit logs

Quick Start

Direct (yo)

cargo build --release
yo -p "explain main.rs"    # one-shot
yo                          # interactive REPL

Gateway + Daemon (Docker)

docker-compose up -d
# Connect via WebSocket at ws://localhost:18789

Documentation

  • DESIGN.md - Technical architecture, protocols, internals
  • USERGUIDE.md - Setup, configuration, security hardening

Inspired By