collabot
v0.2.13
Published
Collabot — the collaborative agent platform
Maintainers
Readme
collabot
The Collaborative Agent Platform. Dispatch, coordinate, and manage AI bots across your projects.
Collabot is home base for your AI bots. It dispatches bots to work on tasks across your projects. You define projects, roles, and bots. Collabot handles dispatch, coordination, event capture, context reconstruction, and communication across four adapters (Slack, CLI, WebSocket, TUI).
Install
npm install -g collabotQuick start
collabot init # scaffold ~/.collabot/
collabot setup # configure roles, bots, and integrations
collabot start # start the harnesscollabot init creates an instance directory at ~/.collabot/ with default configuration, prompt templates, and empty directories for roles, bots, and projects. collabot setup verifies your Claude Code CLI installation, then walks you through role/bot selection and optional Slack integration. Edit ~/.collabot/config.toml to fine-tune model aliases, agent defaults, and adapter settings.
Commands
| Command | Description |
|---------|-------------|
| collabot init | Scaffold a new instance at ~/.collabot/ |
| collabot setup | Interactive wizard — CLI check, roles, bots, Slack |
| collabot start | Start the harness |
| collabot dispatch | One-shot CLI dispatch |
| collabot --version | Print version |
| collabot --help | Show help |
Configuration
Instance configuration lives at ~/.collabot/config.toml. Key sections:
- models — Default model and aliases (e.g.,
opus-latest,sonnet-latest) - agent — Max turns and budget per dispatch
- bots — Bot definitions with default project and role assignments
- slack — Slack adapter settings and per-bot credentials
- ws — WebSocket server port and host
- logging — Log level (
minimal,debug,verbose)
Override the instance location with the COLLABOT_HOME environment variable:
COLLABOT_HOME=/path/to/instance collabot startSecrets (Slack bot tokens, system paths) go in ~/.collabot/.env. Authentication is managed by the Claude Code CLI, not by Collabot directly.
Requirements
- Node.js >= 22
- Claude Code CLI installed and authenticated (
npm install -g @anthropic-ai/claude-code, then runclaudeto log in)
