milind-soni/OpenMausBot

Desktop capability status

The Linux preview is user-initiated and never enables local bot control or Auto routing. On Xorg, the reviewed Cua Driver 0.19.3 runtime starts only after explicit opt-in and without its full-screen cursor overlay. On Wayland the app never starts it and clears legacy opt-ins while that real-seat safety gate remains unresolved. Chat, preview, Cloud, and Local VM remain available on both sessions. See the Ubuntu Desktop guide and tracking issues #29, #345, and #113.

The Linux packager downloads only the tag-pinned upstream archive during the build, verifies its size, SHA-256, complete member allowlist, and inner executable hashes, then packages only the CLI and cursor-theme sidecar. The installed app never downloads or self-updates native automation code. Cua's MIT notice, Inter's SIL OFL, a generated third-party license report, and a CycloneDX inventory ship with the runtime. See thirdparty/cua-driver/ for the reviewed provenance record.

These credentials are optional — local chat works without them. Paste a key once in App Settings (gear in the sidebar footer) when you want to enable its integration:

Composio and Boat are third-party services with their own accounts and terms. Boat is a paid service after its trial, and using a cloud computer may incur charges.

• Packaged app, embedded harness, local agent CLIs — Supported — Beta — Beta
• Composio and Boat/cloud computers — Supported — Beta — Beta
• Explicit preview-only local screen capture — Supported — Beta — Beta
• Bot control of this computer — Supported — Beta, explicit opt-in — Disabled: Wayland safety gate
• Native on-device dictation — Supported — Planned — Planned
• Composio project key (ak…) — Connect Gmail, GitHub, Slack, Notion, and other apps to your bots — OpenMausBot Composio setup
• Boat API key — Give bots an isolated remote Linux computer with a desktop and terminal — Boat API key guide
• ElevenLabs key — Read replies aloud, and call your bots — ElevenLabs API keys
• Fish Audio key — Read replies aloud with Fish Audio voices, and call your bots — Fish Audio API keys

📦 Install a complete team from one Markdown file

Browse outcome-driven teams on BotMRR, then choose Add to OpenMausBot. The app opens a review screen before creating the bots, Chief of Staff, channels, playbooks, connector checklist, and suggested routines. You can also import the same .md file from disk or paste its public GitHub URL in Teams → Import.

The format stays portable: OpenMausBot reads the structured YAML frontmatter for a reliable one-click install, while Grok, Claude, ChatGPT, and people can follow the ordinary Markdown playbook. Connections remain off until you approve them, routines arrive paused, and packages never carry credentials, conversations, permissions, memory, or computer access. Browse the open-source playbook repository or read its portable format.

Quick start

Released builds (latest release): the harness server is embedded, so no separate server setup is required.

See the Ubuntu Desktop guide for installation, capabilities, and troubleshooting. Any desktop build can also pair as a client to another Windows, macOS, or Ubuntu host over Tailscale; see desktop-to-desktop companion mode.

Requirements: macOS, Windows, or Ubuntu 24.04 x64, Node 24+, pnpm, and at least one agent CLI — claude, codex, or grok — installed and logged in. They appear in the model picker automatically.

• macOS (Apple silicon) — OpenMausBot.dmg — Drag it to Applications, open it. Signed & notarized.
• macOS (Intel) — OpenMausBot-intel.dmg — Same app, built for Intel Macs. Signed & notarized.
• Windows (x64) — OpenMausBot-setup.exe — Run it — one-click, per-user, no admin rights. The installer isn't code-signed yet, so SmartScreen shows "unknown publisher": More info → Run anyway.
• Ubuntu 24.04 (x64) — OpenMausBot-amd64.deb · OpenMausBot.AppImage — Install the .deb with APT (recommended), or make the AppImage executable and run it. Beta; GNOME is the supported desktop.

git clone https://github.com/milind-soni/OpenMausBot && cd OpenMausBot
pnpm install

pnpm dev:server    # harness server → 127.0.0.1:8799
pnpm dev           # app → http://127.0.0.1:5199
pnpm dev:desktop   # Electron shell; keep the two commands above running

How it works

Two processes. The app holds no transports of its own — it sends typed commands over HTTP and folds one SSE event stream into state. The harness server owns every agent process and normalizes each provider's native protocol into one canonical runtime event stream (logged per-thread as NDJSON).

• Drivers — server/drivers/ — One per provider: Claude, Codex, and Grok Build over their local CLIs (stream-JSON / JSON-RPC / ACP), plus a cloud-computer agent. Unknown drivers degrade to "unavailable",
• Harness — server/harness/ — Registry (configs → live instances) and the fan-in event bus every client folds.
• API — server/index.ts — Bots, turns, approvals, model catalog, computer lifecycle, connectors, config — HTTP + SSE.
• Voice — server/tts/ — ElevenLabs, Fish Audio, Grok (xAI), built-in Mac voices, or local Chatterbox. Cloud keys stay on the harness; markdown is rewritten into something worth hearing before it is spok
• App — src/ — The chat shell. Server-backed store, one reducer, zero client-side transports.
• Desktop — electron/ — macOS, Windows, and Ubuntu shells with an embedded harness and platform capabilities; Apple speech stays macOS-only, Ubuntu Xorg has opt-in local control, and Wayland remains fai

Why

One assistant in one box is the wrong shape for agents. OpenMausBot is an independent, open-source project inspired by Grok Bot — it keeps the idea (AI as a messaging app: a roster of bots you chat with, each with its own personality, memory of its thread, model, computer, and apps) and rebuilds it open, local-first, and on the agents you already have:

• Bring your own agents. Bots run on the claude, codex, and grok CLIs installed on your own machine
• — your existing logins and subscriptions, no new accounts, no proxy in the middle. Point any engine at a
• custom CLI binary (a versioned build or wrapper) in Settings → Engines.
• events live in ~/.openmausbot, not a cloud.
• Agents with hands. Each bot can use a cloud Linux desktop, an isolated Local VM, or—where the platform
• safety boundary is currently certified—your own computer, plus 500+ apps through Composio. Host control is
• available on macOS and Ubuntu Xorg after explicit opt-in. Ubuntu Wayland host control remains disabled while
• issue #345 is resolved.

The open-source alternative to Grok Bot, Muse, dots and Cue

Four closed personal-agent products shipped in seven weeks of 2026, and each one keeps the model, the computer and your data on its maker's side of the line. OpenMausBot is the open-source version of that shape: a team of agents in a chat app, each with its own model, its own computer and its own connected apps, running on your machine under Apache 2.0. If you searched for an open Muse, open dots, an open-source Grok Bot, an open Instinct or an open Cue, this is the repository.

All five side by side: Muse vs Grok Bot vs Dots vs Cue, and a decision guide in five questions: Which AI agent should I use?

• Open source Grok Bot — xAI's roster of bots on one shared cloud computer, Grok only, from a SuperGrok or Cursor plan — Same roster shape; any model per bot; your own machine; approval cards — Grok Bot
• Open Muse — Meta's single personal agent in a Meta cloud VM, US and Canada only — A team instead of one agent; runs anywhere; data in ~/.openmausbot — Meta Muse alternative
• Open dots — OpenAI's always-on agent inside ChatGPT, GPT only, Pro and Business Premium plans — Several agents; your Claude, ChatGPT or Grok login; no plan required — OpenAI dots alternative
• Open Cue — Manus's invite-only agents with their own phone, email and wallet — No invite; OAuth instead of passwords; open source — Cue by Manus alternative
• Open Instinct — Spear Street's invite-only agent that holds your passwords on a cloud computer — Ask for approval when you want it; signs in over OAuth; your machine — Instinct AI alternative

🧠 Pick a brain per bot

A model picker with a provider rail — Claude and Codex models side by side, defaults marked, unavailable providers dimmed with the reason. Switch a bot's model mid-conversation.