Verbo

A real-time terminal overlay for orchestrating multiple Claude Code agents across your engineering team.

Install

npm install -g verbolab

Quick Start

verbo                        # Launch TUI overlay
verbo add "task"             # Add a task
verbo list                   # List tasks
verbo status                 # Quick status

Or use without installing:

npx verbolab

MCP Server

Verbo exposes an MCP server that Claude Code agents connect to. Agents can claim tasks, report progress, detect file conflicts, and create subtasks — all through native MCP tools.

Relay Server (Team Sync)

npm run relay                     # Start relay on ws://localhost:4800
VERBO_RELAY_PORT=5000 npm run relay  # Custom port

CI/CD Setup

Verbo agents push frequently — multiple commits per hour is normal. If your project auto-deploys on every push (Vercel, Netlify, etc.), you'll hit build limits fast.

Recommended setup: Use a separate branch for production deploys.

1. Create a production branch: git checkout -b production && git push origin production
2. Configure your platform to only build from production:
   • Vercel: Settings → General → Ignored Build Step → "Only build production"
   • Netlify: Settings → Build & Deploy → Branch deploy controls → set to production only
3. Deploy when ready: git checkout production && git merge master && git push origin production

This way agents work freely on master without burning your build quota.

Development

npm test           # Run all tests
npm run test:watch # Watch mode
npm run build      # TypeScript compile

Key Bindings (TUI)

| Key | Action | |-----|--------| | n | New task | | a | Assign | | l | Launch agent | | Enter | Parallelize batch | | x | Kill agent | | t | Team view | | j/k | Navigate | | ? | Help | | Esc | Dismiss |