BFG SolutionsBFG Solutions

Products/Swarm

Swarm

Open source

A web-based control center for AI coding agents.

Manage one agent or ten from a single browser tab — with autopilot, a task board, AI coordination, and email integration. Every agent session runs in a managed PTY; the dashboard gives you real-time visibility, terminal attach, and proposal-based oversight. Works with Claude Code, Gemini CLI, and Codex CLI.

View on GitHubInstallation guide
Swarm dashboard — workers sidebar, terminal, and task board

The Swarm dashboard — worker sidebar, attached terminal, task board, and proposals banner.

Install

Requires Python 3.12+ and uv. One command puts swarm on your PATH:

uv tool install git+https://github.com/miopea/swarm.git
swarm init    # configure workers, hooks, and the auto-start service
swarm start   # launch workers + dashboard at http://localhost:9090

swarm init installs the Claude Code auto-approval hooks, scans ~/projects for git repos, and sets up an OS background service (systemd on Linux/WSL, launchd on macOS) so the dashboard auto-starts on boot.

What it does

  • Live terminal attach

    Type into any worker's agent session from the browser via a full xterm.js PTY-over-WebSocket bridge. Up to 20 concurrent sessions.

  • Task board with email & Jira import

    Drag .eml/.msg files, Outlook tiles, or Jira URLs onto the board to create tasks. WYSIWYG editor, Markdown round-trip, dependencies, attachments.

  • Background drones

    Specialized watchers auto-approve safe prompts, revive crashed agents, watch context pressure, and escalate hard decisions — your sessions never stall.

  • Queen conductor

    A headless Claude assigns tasks to the right worker, detects completion, drafts email replies, and resolves conflicts. Every action goes through proposals you approve with one click.

  • MCP server for inter-agent coordination

    Workers coordinate via 12 MCP tools — send findings, claim files, share learnings, report progress. The Queen has 15 elevated tools for hive-wide oversight.

  • Pipelines & skill workflows

    Multi-step workflows with AGENT, AUTOMATED, and HUMAN steps. Tasks dispatch as Claude Code skill commands (/fix-and-ship, /feature, /verify) backed by a SQLite registry.

  • Outlook & Jira integration

    Microsoft Graph OAuth for email-driven tasks; Atlassian OAuth 2.0 for two-way Jira sync with ADF → Markdown conversion.

  • Remote access via Cloudflare Tunnel

    Toggle a tunnel from the dashboard and reach the control center from your phone. Optional named domain for stable URLs.

Open source & feedback

Swarm is MIT-licensed. File bugs and feature requests on GitHub — or use the in-app feedback button, which files an issue via the gh CLI with sensitive paths automatically redacted. For everything else, email info@bfgsolutions.net.