Autonomous agent
fleet. |

OpenFleet 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.

  • Multi-executor: Copilot, Codex, Claude
  • GitHub, Jira & Vibe-Kanban integrated
  • Telegram + WhatsApp push alerts
  • Auto-fix lint, CI failures & retry loops
$ npm install -g @virtengine/openfleet 📋 Copied!
v0.26 · GitHub Projects v2 · Jira sync · Apache 2.0
openfleet — bash — 120×35
Telegram
OpenFleet

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

🤖
OpenFleet Alerts
online
Today

WhatsApp delivers real-time push notifications for task events, PR merges, CI status, and fleet digests. Natural language queries work too.
Enable with: openfleet --whatsapp-auth

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, OpenFleet 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.

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 OpenFleet 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 @virtengine/openfleet
2

Setup

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

openfleet --setup
3

Launch

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

openfleet
Shipping Code

Live from VirtEngine

Real pull requests created and merged by OpenFleet's AI agents. Powered by Codex, Copilot, and Claude — shipping production code daily.

Loading recent PRs from VirtEngine...
Configuration

Simple to configure

A single .env file controls everything. Or use the setup wizard for zero-config starts.

# ─── OpenFleet 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.