OpenMausBot

Local-first desktop chat workspace where each bot runs Claude, Codex, or Grok CLI with its own thread, model, computer, connected apps, and approval flow; includes MCP and headless CLI control. Apache-2.0 licensed.

View on GitHub Unknown

A local-first desktop chat app where each bot runs its own Claude, Codex, or Grok CLI agent with its own model, computer, and apps.

What it is

OpenMausBot is an Apache-2.0 licensed desktop workspace that presents AI agents as a roster of chat contacts. Each bot runs on a Claude, Codex, or Grok CLI already installed on your machine, so it uses your existing logins rather than a new account. A small harness server on 127.0.0.1 manages every agent process, and transcripts, keys, and events are stored in ~/.openmausbot. Each bot has its own thread, model, computer, and connected apps, and risky actions go through an approval flow before they run. The project also offers MCP and headless CLI control.

Key features

  • Per-bot engine, model, and thread, switchable mid-conversation
  • Cloud, local VM, or opt-in host computer access for each bot
  • Inline Allow/Deny approval cards for shell commands and file edits
  • Connected apps marketplace built on Composio Sessions
  • Channels that keep separate contexts with their own bot rosters
  • Optional voice output and calls, including ElevenLabs and Grok TTS

Use cases

  • Running several specialized agents for different projects, each in its own channel
  • Keeping agent activity local while still reviewing each risky action before it executes
  • Reusing existing Claude, Codex, or Grok subscriptions instead of signing up for a new product
  • Listening to overnight agent results through read-aloud replies

Who it's for

Developers and power users who already run Claude, Codex, or Grok CLI and want a single chat-style place to manage several agents. It suits people who prefer local data storage and explicit approval of agent actions.

Getting started

The supplied README does not include clearly verbatim setup commands, so no install commands are given here. Official downloads for macOS, Windows, and Ubuntu are linked from the project's releases page, and the README describes installing the Claude, Codex, or Grok CLIs on your machine as the basis for running bots.

Alternatives

The related directory entries include Deer-Flow, Maka, Swarms, Mastra, OpenAI Agents SDK, Symphony, Paperclip, AgentScope, Microsoft Agent Framework, NarraNexus, and Agency Swarm. These are listed as related entries only; this guide does not claim any project endorses or compares them.

Drafted with AI from the project's public documentation; verify against the source. Written 1 Nov 2026.

Nearby on the map

Related projects