Repolode
Submit
milind-soni

milind-soni/OpenMausBot

Open-source desktop and self-hosted chat app where each bot is a local Claude, Codex or Grok agent with its own model, cloud computer and connected apps.

Open-source alternative to:Grok Bot

View on GitHubWebsite
Stars
16,757
Forks
2,377
Open issues
470
Last commit
4 hours ago

What is it?

OpenMausBot is a chat-style app for running a team of AI agents. Each bot in the sidebar has its own personality, model, conversation memory, cloud Linux desktop, and connected apps, and you talk to it like a contact. The bots run on the claude, codex, and grok CLIs already installed on your machine, so existing logins and subscriptions are used directly without a proxy.

A local harness server on 127.0.0.1 manages every agent process and normalizes their output into one event stream. Transcripts, keys, and events are stored in ~/.openmausbot. Shell commands, file edits and questions appear as approval cards in the chat, and a permission broker asks you before risky actions run.

The project ships as Electron builds for macOS, Windows and Ubuntu 24.04, and can also be run from source or installed from npm as a terminal-launched web UI. Composio provides connections to hundreds of apps such as Gmail, Slack and GitHub, and triggers can run bots on schedules or webhooks. It is licensed under Apache 2.0.

Key features

  • 01Chat with multiple bots, each with its own model, personality and memory.
  • 02Runs on locally installed Claude, Codex and Grok CLIs using existing logins.
  • 03Per-bot cloud Linux desktop, or control of the local Mac or Ubuntu Xorg machine after opt-in.
  • 04Inline approval cards for shell commands, file edits and questions.
  • 05Connected apps via Composio, plus schedules and webhook triggers.
  • 06Team templates and sharing as Markdown or YAML files, with secrets excluded.

Use cases

  • Running several specialized AI assistants for work, personal tasks and separate projects in one chat app.
  • Keeping agent work and API credentials on your own machine rather than a hosted service.
  • Automating recurring tasks such as a daily inbox summary or replying to webhook events.
  • Driving bots from scripts or CI with the openmausbot command-line interface.

Quick start

  1. 1

    Download the app for your platform from the latest release page

  2. 2

    Install the claude, codex or grok CLI on your machine and sign in to it

  3. 3

    Open the app and pick a bot's model in the chat

Things to know

  • Bots need the claude, codex or grok CLI installed locally and a working login or subscription for them.
  • Desktop builds exist only for macOS, Windows and Ubuntu 24.04 x64.
  • Host control on Ubuntu Wayland is disabled while issue #345 is open.

In collections

Claude Code tools, skills & pluginsOpen-source AI agent frameworks & appsAI coding assistants & agentsSelf-hosted apps

Topics

#ai-agents#chat#self-hosted#electron#claude#computer-use#automation#claude-code#codex#docker

FAQ

What is OpenMausBot?
Open-source desktop and self-hosted chat app where each bot is a local Claude, Codex or Grok agent with its own model, cloud computer and connected apps. OpenMausBot is a chat-style app for running a team of AI agents. Each bot in the sidebar has its own personality, model, conversation memory, cloud Linux desktop, and connected apps, and you talk to it like a contact. The bots run on the claude, codex, and grok CLIs already installed on your machine, so existing logins and subscriptions are used directly without a proxy.
Is OpenMausBot free to use? What license does it have?
OpenMausBot is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is OpenMausBot still maintained?
Actively maintained. The last commit to OpenMausBot was on Nov 7, 2026.
What can I use OpenMausBot for?
Running several specialized AI assistants for work, personal tasks and separate projects in one chat app. Keeping agent work and API credentials on your own machine rather than a hosted service. Automating recurring tasks such as a daily inbox summary or replying to webhook events. Driving bots from scripts or CI with the openmausbot command-line interface.
How do I install OpenMausBot?
Download the app for your platform from the latest release page Install the claude, codex or grok CLI on your machine and sign in to it Open the app and pick a bot's model in the chat
Where can I get OpenMausBot?
The source code and installation instructions are on GitHub: https://github.com/milind-soni/OpenMausBot

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects