A Fleet of Bots, Built on OpenMausBot

BotFleet is a distribution of the open-source OpenMausBot desktop app, extended to run a coordinated fleet of specialized bots on your own Mac.  This page tracks the add-on features BotFleet layers on top of upstream OpenMausBot and how far along each one is.

Join the iOS TestFlight Public beta of the iOS companion.  A Mac TestFlight is planned.

An example fleet — the bots the maintainer runs today:

DirectorProducerPublisherOracleBuilderFixerDesignerCompilerMonitorPlumberHousekeeperFirefighter
Established  Merged to main, or deployed and verified in daily use.
Beta  Shipped in a BotFleet branch or pull request and still under review or active testing.
The open pull requests build on one another, so a feature can appear in more than one PR's diff.  Each card cites the pull request where the work originated.

Established & Tested Established

Running in production today.

Always-On iMessage Relay

A background relay daemon keeps every BotFleet bot group chat in Messages.app connected to the BotFleet backend in both directions.  LaunchAgents keep the relay and the server alive across logouts and reboots, so the fleet stays reachable from your phone.

Deployed · running against the fleet's bot group chats

iOS Companion Deep-Link Infrastructure

App Groups and Associated Domains entitlements, BotFleet bundle identifiers, and a hosted apple-app-site-association file wire the iOS companion for universal links and TestFlight distribution.

Merged to main

Dynamic Bot Mascot Expressions

Bot mascots change expression with what the bot is doing, so a glance at the sidebar reads like a status board.

Pull request #6 · merged

Beta Beta

Feature-complete and in active review or testing.

Multi-Tier Model Fallbacks

Give each bot a first, second, and third choice model.  When the primary hits rate limits, quota, or an outage, BotFleet falls down the chain and retries automatically — no babysitting required.

Pull request #5 · open

Native DeepSeek Driver

A native ACP driver plus the dsh agent bring DeepSeek V3 and R1 into the fleet alongside Claude, Codex, and Cursor, so every bot can run on the model that fits its job.

Pull request #5 · hardened in #7

Mid-Task Restart Recovery

Interrupted tasks and tool runs resume automatically after an app quit, crash, or reboot, instead of leaving a bot stuck mid-thought.

Pull request #5 · open

Fleet MCP Tools & Standard Skills

Global MCP servers from your Claude configuration are merged in and made available to every bot running on the Claude driver, and a standard skill set ships with the repo so agents working on BotFleet start with fleet conventions loaded.

Pull request #1 · open

Usage Telemetry Streaming

Token usage and cost metrics stream to a Usage Monitor dashboard, classified by project and repo, so every bot's spend is visible in one place.

Pull request #5 · open

Multi-Repo Channels & File Links

Channels can span multiple repositories, with project classifiers and clickable markdown and file links that jump straight to the source.

Pull request #5 · open

Chat Copy Controls

Click a bubble to copy it, hover for a copy button, and grab request IDs for tracing — transcript text stops fighting you.

Pull request #5 · open

Custom Webhook Domain

Point webhook ingress at your own public domain instead of a generated tunnel address, with URL validation on the configured host.  The secret-token endpoints can then trigger bots from CI, GitHub, and data pipelines at a stable address you control.

Pull request #5 · open

macOS Tray Integration

A menu bar tray icon keeps the fleet one click away, even when the main window is closed.

Pull request #5 · open

Dynamic System Theme

Dark and light mode follow macOS automatically, with the fixed theme modes still available.

Pull request #5 · open

Update Controls

An auto-update toggle and update banner preferences put release timing in your hands instead of the updater's.

Pull request #5 · open

Routine Detail Navigation

Jump straight from a bot's settings panel into a routine's detail view to inspect schedules and recent runs without hunting through menus.

Pull request #5 · open

Channel Avatar Uploads & UI Polish

Set channel avatars from local photos through the standard file picker — a flow upstream reserves for bots — with refined chat spacing and clearer Local Setup naming throughout.

Pull request #5 · open

Animated Avatar Formats

Moving GIF and HEIC images work as avatars, so bots and channels can wear live mascots.

Pull request #7 · open

Model Catalog Refinements

Unavailable models are filtered out of pickers, engine settings are reordered, and provider icons plus the Codex model list are refreshed.

Pull request #7 · open

Custom BotFleet Brand & Icons

A custom vanguard-style logo and matching macOS and iOS app icons give BotFleet its own identity, separate from upstream's mascot.

Pull request #5 · open

One-Command TestFlight Ship

A thin in-repo wrapper hands the iOS companion to the fleet's centralized ship automation on the host machine, so one command archives, signs, and uploads to TestFlight.

Pull request #4 · merged to integration branch