Bosun Documentation

Bosun is an open-source autonomous supervisor for AI coding workflows. It watches task execution, routes work across agent executors (Copilot, Codex, Claude), handles retries/failover, automates PR lifecycle, and keeps you in control through Telegram, WhatsApp, and a full-featured control center.

💡

New to Bosun? Start with the Quick Start guide — it takes less than 5 minutes.

Why Bosun?

AI coding agents are fast, but unattended loops are expensive:

Bosun is the control plane that keeps delivery moving: task routing, monitored orchestration, conflict/PR lifecycle automation, and live bot control.

Core Capabilities

Capability Description
Multi-Executor Routing Weighted distribution across Copilot, Codex, and Claude with automatic failover
Smart PR Flow Creates PRs, monitors CI, auto-rebases, merges on green
Self-Healing Autofix patterns, circuit breakers, heartbeat-based stale recovery
Task Boards Internal board + GitHub Issues + GitHub Projects v2 + Jira adapters
Telegram Control 30+ bot commands, Mini App with 7 tabs, sentinel watchdog
Multi-Agent Coordination Shared state, atomic claims, heartbeat liveness, stale sweeps
Container Isolation Docker, Podman, and Apple Container support with concurrent limits

Documentation Guide

🚀 Quick Start

Install, configure, and launch your first fleet in under 5 minutes.

⚙️ Configuration

Complete reference for .env, JSON config, executors, and env var overrides.

💻 CLI Reference

Every flag, command, and option documented with examples.

🏗️ Architecture

How the supervisor, orchestrator, and agents fit together.

🔗 Integrations

GitHub, Telegram, Jira, WhatsApp, Docker, Cloudflare — all covered.

Requirements

Next →
Quick Start