Servus is an autonomous multi-agent engineering CLI. Give it a task, and a team of specialized AI agents — Planner, Developer, Tester, and Manager — will coordinate to deliver a complete, tested solution with a live TUI dashboard.

Quickstart

# Install globally
npm install -g servusai

# Run a task
servus "Build a real-time chat app with WebSocket"

Or from source:

git clone https://github.com/TangoBeee/servus.git
cd servus
npm install && npm start

How It Works

You ──→ Planner ──→ Developer ──→ Tester ──→ Manager ──→ Done
          │            │             │            │
       Creates      Researches    Runs builds   Reviews
       task graph   & writes code & tests       & summarizes

All four agents run inside a live TUI dashboard that shows real-time progress, costs, and agent activity:

┌──────────────────────────────────────────────────────────────┐
│ SERVUS │ Live Dashboard                             RUNNING  │
└──────────────────────────────────────────────────────────────┘
 Task: Build a real-time chat app...        3/4 tasks  $0.94
 ████████████████████░░░░░░ 3/4

 AGENT ACTIVITY
 [Planner]    done   (4 tasks planned)              $0.11
 [Developer]  done   (steps: 12, 8 files written)   $0.87
 [Tester]     done   (all tests passing)             $0.27
 [Manager]    working...

Features

| Feature | Description | |---|---| | Multi-Agent Team | Planner, Developer, Tester, and Manager coordinate via a structured task graph with dependencies | | Interactive TUI | Live dashboard with progress bars, agent activity, costs, and follow-up prompts | | Multi-Provider LLM | OpenAI, Anthropic Claude, and Google Gemini — switch with a single config change | | Smart Discovery | Auto-indexes files, builds directory trees, computes PageRank on symbol graphs | | Session Memory | Sessions stored under ~/.servus — revisit runs and add follow-ups later | | Safe on Existing Projects | Runtime guards prevent destructive commands and accidental overwrites |

Configuration

Set your API key as an environment variable:

# Pick one (or set multiple and switch via config)
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export GOOGLE_GENERATIVE_AI_API_KEY="..."

Disclaimer

Servus is an AI agent and can make mistakes. It may write incorrect code, run unexpected commands, or modify files in unintended ways. Always review the changes it makes. Use at your own risk. We recommend running Servus in a git-tracked project so you can easily revert any unwanted changes.

License

MIT — see LICENSE for details.