Autonomous engineering with human oversight is addressed by Bosun, a production-grade control plane. It targets engineers and operators seeking to automate complex software delivery pipelines, offering benefits like orchestrated task execution, automated PR management, and real-time control via Telegram and a dashboard.

How It Works

Bosun functions as an orchestrator, planning and routing work across various AI executors (Codex, Copilot, Claude, OpenCode). It automates the entire PR lifecycle, including quality gates (build, tests, reviews) and merging, while persisting workflow runs for resilience. The system ensures operators remain in control through Telegram notifications and a Mini App dashboard, translating high-level goals into disciplined, automated execution.

Quick Start & Requirements

• Primary install: npm install -g bosun or via Docker: docker run -d --name bosun -p 3080:3080 -v bosun-data:/data -e BOSUN_API_KEY=your-secret-key virtengine/bosun:latest.
• Prerequisites: Node.js 18+, Git Bash or PowerShell 7+, GitHub CLI (gh). Requires extensive Cloudflare setup for the Mini App tunnel (e.g., CLOUDFLARE_TUNNEL_NAME, CLOUDFLARE_TUNNEL_CREDENTIALS, CLOUDFLARE_BASE_DOMAIN, CLOUDFLARE_ZONE_ID, CLOUDFLARE_API_TOKEN).
• Documentation: Official docs are available at https://bosun.engineer/docs/.

Highlighted Details

• Automates PR lifecycles, including auto-labeling PRs with bosun-needs-fix on CI failure and merging passing PRs after a mandatory review gate.
• Supports professional, end-to-end autonomous delivery workflows encompassing trigger intake, planning, routed execution, quality gates, and recovery.
• Integrates with multiple AI executors: Codex (OpenAI), Copilot (VS Code), Claude, and OpenCode.
• Provides Telegram control and a Mini App dashboard for monitoring, management, and status reporting.

Maintenance & Community

The repository is hosted on GitHub, with links provided for the project website and npm. Specific details regarding active contributors, sponsorships, or dedicated community channels (like Discord/Slack) are not detailed in the provided README snippet.

Licensing & Compatibility

Licensed under the Apache-2.0 license. This license generally permits commercial use and integration into closed-source projects.

Limitations & Caveats

Bosun can deadlock if Git requires an interactive editor during operation; users must configure a non-interactive Git editor (e.g., git config --global core.editor "echo"). The Mini App dashboard functionality necessitates a complex Cloudflare setup. Preflight checks and git hooks enforce strict quality standards that may require initial configuration adjustments.