v0.0.0 · Live

Your Autonomous Engineer,
|

$ npm install -g bosun Copied!
Bosun Desktop Electron
bosun — bash — 120×35
Telegram
Bosun

Live from source — auto-updates when the real MiniApp changes

0+
Modules
0
Executor Engines
0
Board Backends
0
Control Channels
0%
Open Source
Features

Everything you need to run an autonomous fleet

From task routing to PR merging, Bosun handles the full lifecycle so your AI agents can focus on writing great code.

Multi-Executor Routing

Weighted distribution across Copilot (Claude Opus, GPT), Codex, and Claude agents. Automatic failover with cooldown and retry limits.

Smart PR Lifecycle

Creates PRs, monitors CI, auto-rebases on conflict, and merges when all checks pass. Full lifecycle automation from branch to merge.

Self-Healing Recovery

Autofix detects failure patterns, circuit breakers prevent loops, and stale claims are automatically reclaimed via heartbeat monitoring.

Flexible Task Boards

Built-in internal board, plus native adapters for GitHub Issues, GitHub Projects v2, and Jira. Bidirectional sync keeps everything in agreement.

Telegram Control Center

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.

Multi-Agent Coordination

Shared state with atomic claims, heartbeat liveness, and stale sweeps. Multiple workstations coordinate without duplicate work.

Fleet Coordination

Presence tracking, session management, workspace registry, and fleet-wide state persistence across multiple machines and agents.

Container Isolation

Optionally run agents inside Docker, Podman, or Apple Container sandboxes. Full image management and concurrent container limits.

Setup Wizard

Interactive setup generates a complete .env with documentation. Recommended mode for quick starts, Advanced mode for full control.

Workflows

Operator-grade workflow automation

Bosun templates are not toy automations. They coordinate planning, execution, review, recovery, and merge with explicit controls so your autonomous engineer can run at speed without losing safety.

Decisioned PR Gates

Multi-step merge strategy with CI awareness, review requirements, and explicit merge/no-merge outcomes.

  • CI status + review checks
  • Conflict-aware branch policy
  • Automated pass/fail labeling

Autonomous Planning Loop

Structured planning workflows break work into tasks, attach context, and dispatch to the right executor.

  • Task decomposition
  • Executor-aware routing
  • Context + prompt templating

Self-Healing Recovery Paths

Recovery templates capture stalled runs, retry with policy, and escalate only when automation cannot recover safely.

  • Retry and cooldown policies
  • Stuck-run detection
  • Escalation + alert hooks
Lifecycle Blueprint
Stage 1
Trigger Intake
Issue · Comment · Schedule · Webhook
Stage 2
Plan + Scope
Classify work · Select template · Build context
Stage 3
Execute + Validate
Agent run · Tests · Build · Quality hooks
Stage 4
Review + Merge
PR policy · Approval gates · Merge decision
Stage 5
Observe + Recover
Telemetry · Auto-heal · Operator alerts
Security

Built secure by default

Every layer is locked down — from Telegram token verification to container-isolated agent execution. Click any card to see the technical details.

Architecture

How Bosun works

A modular supervisor that orchestrates the entire journey from task to merged PR.

Task Board
GitHub / Jira / Internal
Supervisor
monitor.mjs
Agent Pool
Copilot / Codex / Claude
Orchestration
  • Task routing & weighted distribution
  • Executor failover & cooldowns
  • Smart PR lifecycle automation
  • Conflict resolution & auto-rebase
  • Circuit breaker & error recovery
Coordination
  • Shared state with atomic claims
  • Heartbeat-based liveness detection
  • Multi-workstation fleet sync
  • Workspace & worktree management
  • Session & presence tracking
Control Surfaces
  • Telegram Bot with 30+ commands
  • Mini App (7-tab web dashboard)
  • WhatsApp channel (optional)
  • Interactive CLI shell mode
  • Sentinel watchdog companion
Integrations

Connects to your entire stack

GitHub
Issues, Projects v2, PRs, CI checks
Telegram
Bot, Mini App, Sentinel watchdog
Jira
Full status mapping & custom fields
WhatsApp
Optional notification channel
Docker / Podman
Container-isolated agent execution
Copilot
Claude Opus, GPT, agent sessions
Codex
OpenAI Codex SDK & persistent sessions
Cloudflare Tunnel
Persistent HTTPS for Mini App
Quick Start

Up and running in 3 steps

1

Install

Install globally from npm. Requires Node.js 18+ and git.

npm install -g bosun
2

Setup

Run the interactive wizard. Choose Recommended mode for fast setup.

bosun --setup
3

Launch

Start the supervisor. It auto-connects to your configured board and agents.

bosun
Shipping Code

Live from VirtEngine

Real pull requests merged & commits shipped by Bosun's AI agents. Powered by Codex, Copilot, and Claude — shipping production code daily.

Loading recent PRs from VirtEngine...
Loading recent commits to bosun...
Configuration

Simple to configure

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"
    }
  ]
}

Ready to automate your fleet?

Open source, extensible, and built for production. Start shipping faster with autonomous AI agents today.