Bosun is the open-source supervisor for AI coding agents. Route tasks, manage multi-executor pools, automate PR lifecycles, and ship production code — without human intervention.
Live from source — auto-updates when the real MiniApp changes
WhatsApp delivers real-time push notifications for task events, PR merges, CI status, and fleet digests. Natural language queries work too.
Enable with: bosun --whatsapp-auth
From task routing to PR merging, Bosun handles the full lifecycle so your AI agents can focus on writing great code.
Weighted distribution across Copilot (Claude Opus, GPT), Codex, and Claude agents. Automatic failover with cooldown and retry limits.
Creates PRs, monitors CI, auto-rebases on conflict, and merges when all checks pass. Full lifecycle automation from branch to merge.
Autofix detects failure patterns, circuit breakers prevent loops, and stale claims are automatically reclaimed via heartbeat monitoring.
Built-in internal board, plus native adapters for GitHub Issues, GitHub Projects v2, and Jira. Bidirectional sync keeps everything in agreement.
Full bot with 30+ commands, inline keyboards, live digest system, and a rich Mini App with 7 tabs — Dashboard, Tasks, Agents, Infra, Control, Logs, Settings.
Shared state with atomic claims, heartbeat liveness, and stale sweeps. Multiple workstations coordinate without duplicate work.
Presence tracking, session management, workspace registry, and fleet-wide state persistence across multiple machines and agents.
Optionally run agents inside Docker, Podman, or Apple Container sandboxes. Full image management and concurrent container limits.
Interactive setup generates a complete .env with documentation. Recommended mode for quick starts, Advanced mode for full control.
Every layer is locked down — from Telegram token verification to container-isolated agent execution. Click any card to see the technical details.
A modular supervisor that orchestrates the entire journey from task to merged PR.
Install globally from npm. Requires Node.js 18+ and git.
Run the interactive wizard. Choose Recommended mode for fast setup.
Start the supervisor. It auto-connects to your configured board and agents.
Real pull requests created and merged by Bosun's AI agents. Powered by Codex, Copilot, and Claude — shipping production code daily.
A single .env file controls everything. Or use the setup wizard for zero-config starts.
# ─── Bosun Environment Configuration ───
# Core
PROJECT_NAME=virtengine
GITHUB_REPO=virtengine/virtengine
GITHUB_TOKEN=ghp_xxxxxxxxxxxx
# Executor Pool
EXECUTOR_MODE=internal
EXECUTORS=COPILOT:CLAUDE_OPUS_4_6:50,CODEX:DEFAULT:50
MAX_PARALLEL=6
AGENT_TIMEOUT=90
# Task Board
KANBAN_BACKEND=github
GITHUB_PROJECT_NUMBER=4
# Notifications
TELEGRAM_BOT_TOKEN=7891234567:AAG...
TELEGRAM_CHAT_ID=1234567890{
"version": 1,
"executors": {
"pool": [
{
"name": "copilot-claude",
"sdk": "copilot",
"model": "claude-opus-4-6",
"weight": 50
},
{
"name": "codex-default",
"sdk": "codex",
"model": "o4-mini",
"weight": 50
}
],
"failover": { "maxRetries": 2, "cooldown": 300 }
}
}{
"hooks": [
{
"name": "prepush-go-vet",
"event": "PrePush",
"command": "go vet ./...",
"blocking": true
},
{
"name": "precommit-gofmt",
"event": "PreCommit",
"command": "gofmt -w ."
},
{
"name": "task-complete-audit",
"event": "TaskComplete",
"command": "./scripts/agent-preflight.sh"
}
]
}Open source, extensible, and built for production. Start shipping faster with autonomous AI agents today.