bosun

<p align="center"> <img src="site/logo.png" alt="virtengine bosun ai agent" width="150" /> </p> <h1 align="center">bosun</h1>

Bosun is a production-grade supervisor for AI coding agents. It routes tasks across executors, automates PR lifecycles, and keeps operators in control through Telegram, the Mini App dashboard, and optional WhatsApp notifications.

<p align="center"> <a href="https://bosun.virtengine.com">Website</a> · <a href="https://bosun.virtengine.com/docs/">Docs</a> · <a href="https://github.com/virtengine/bosun?tab=readme-ov-file#bosun">GitHub</a> · <a href="https://www.npmjs.com/package/bosun">npm</a> · <a href="https://github.com/virtengine/bosun/issues">Issues</a> </p> <p align="center"> <img src="site/social-card.png" alt="bosun — AI agent supervisor" width="100%" /> </p> <p align="center"> <a href="https://github.com/virtengine/bosun/actions/workflows/ci.yaml"><img src="https://github.com/virtengine/bosun/actions/workflows/ci.yaml/badge.svg?branch=main" alt="CI" /></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="License" /></a> <a href="https://www.npmjs.com/package/bosun"><img src="https://img.shields.io/npm/v/bosun.svg" alt="npm" /></a> </p>

---

Quick start

npm install -g bosun
cd your-repo
bosun

First run launches setup automatically. You can also run setup directly:

bosun --setup

Requires:

• Node.js 18+
• Git
• Bash (for .sh wrappers) or PowerShell 7+ (for .ps1 wrappers)
• GitHub CLI (gh) recommended

---

What Bosun does

• Routes work across Codex, Copilot, and Claude executors
• Automates retries, failover, and PR lifecycle management
• Monitors runs and recovers from stalled or broken states