repowiserepowise

App

milind-soni / openmausbot

Open-source Grok Bot alternative with a virtual machine that bots can use

★ 26,634stars on GitHubTypeScriptApache-2.0

This connects Repowise to milind-soni/openmausbot's code. It does not install openmausbot.

Repowise maps public repos from their source. Not affiliated with milind-soni. What is Repowise?

github.com/milind-soni/openmausbotIndexed at 57405b5

What is openmausbot?

OpenMausBot is an open-source chat app for running a team of AI bots on your own machine, each with its own model and connected apps. Each bot is a real agent, such as Claude or Codex running locally, and you talk to the bots as you would to contacts. The app is written in TypeScript and relies on a harness server on 127.0.0.1 that owns the agent processes. To install it, run git clone https://github.com/milind-soni/openmausbot.git and follow the steps below. Its code health is 7.5 out of 10 (Good), ranked #108 of 4,000+ indexed repos. The last commit to openmausbot was on Nov 16, 2026, and 300 people have contributed.

As of commit 57405b5, indexed Nov 17, 2026. What it is comes from a model reading the README; the rest is measured from the source and git history, not from the maintainer.

For agentsopenmausbot.md

Repo facts: type, license, health, rank, contributors
openmausbot facts
TypeApp
LicenseApache-2.0
Code health7.5 / 10 (Good)
Health rank#108 of 4,000+ indexed repos
Last commitNov 16, 2026
Contributors300
Bus factor1
Size7,465 files, 1,079,366 lines

Install openmausbot

Commands copied from the README

  1. 1Clone the openmausbot repository.
    git clone https://github.com/milind-soni/openmausbot.git
  2. 2Move into the openmausbot folder.
    cd openmausbot
  3. 3Install the dependencies from a source checkout
    pnpm install
  4. 4Start the harness server on 127.0.0.1:8799
    pnpm dev:server
  5. 5Start the Electron desktop shell, keeping the two commands above running
    pnpm dev:desktop

Full install notes on GitHub

Explore openmausbot

Ask about this code in your agent

This connects Repowise to openmausbot's code. It does not install openmausbot. To install openmausbot, use the install steps.

Useful if you want to change or fork openmausbot: your agent can ask how it is put together and get answers that cite its files.

Ask about openmausbot

Answers come from openmausbot's README and source, with the files they cite. Two free answers a day without an account.

Featured answer

OpenMausBot is an open-source chat app for running a team of AI bots on your own machine, where each bot is a real local agent such as Claude or Codex that you talk to like a contact. It runs as two processes: the TypeScript chat app in src/ sends typed commands over HTTP and folds the server's SSE event stream into its state, while the harness server on 127.0.0.1 owns every agent process. The harness normalizes each provider's protocol into one canonical event stream logged per thread as NDJSON, with one driver per provider in server/drivers/, and server/harness/ holds the registry and event bus. server/index.ts exposes bots, turns, approvals, connectors and configuration as HTTP and SSE endpoints, and electron/ wraps everything as a desktop shell for macOS, Windows and Ubuntu. For a first read, start with server/index.ts and server/drivers/, then the UI layer with 604 files in the chart.

Files per layer in openmausbot9 layers.

Basis: Inferred · knowledge graph· as of 57405b5

Want this for your own codebase? Map your repo free

About this page

Get a page like this for your own codebase

Repowise built this map of milind-soni/openmausbot from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Free for 2 public repos, with a page like this one. No card. See how Repowise works

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed. Star Repowise on GitHub

milind-soni/openmausbot FAQ

What is OpenMausBot?

OpenMausBot is an open-source chat app for running a team of AI bots on your own machine. Each bot is a real agent, such as Claude or Codex running locally, with its own personality, model and connected apps.

How does OpenMausBot work?

OpenMausBot runs a harness server that owns every agent process and normalizes each provider's protocol into one event stream. The chat app sends commands over HTTP and updates its state from the SSE events the server sends back.

How do I install OpenMausBot?

From source, run pnpm install, then start pnpm dev:server and pnpm dev, and pnpm dev:desktop for the Electron shell. Released builds are available for macOS, Windows and Ubuntu 24.04 x64. See the install steps

What language is OpenMausBot written in?

OpenMausBot is written primarily in TypeScript. Its code also includes JavaScript files, along with a smaller number of shell, Dockerfile, Python and Swift files.

How is the OpenMausBot code organized?

server/ holds the harness, with server/drivers/ for each provider and server/index.ts for the HTTP and SSE API. src/ holds the chat app and electron/ holds the desktop shell.

Who is OpenMausBot for?

OpenMausBot is for people who already use the claude, codex or grok CLIs and want to talk to those agents as bots in a chat app. It runs locally and uses the logins and subscriptions you already have.

What license does OpenMausBot use?

OpenMausBot is licensed under Apache-2.0. The project is open source and runs on your own machine.

Code health

7.4out of 10Good

Hotspots average 6.2, the place fixes pay off most.

On the leaderboards:#40 of 70 TypeScript repos

Key features of openmausbot

  • Bots run on the claude, codex and grok CLIs already installed and logged in on your machine, without a proxy in between.
  • A harness server on 127.0.0.1 owns every agent process, and transcripts, keys and events are stored in ~/.openmausbot.
  • Each bot can use a cloud Linux desktop, an isolated Local VM or your own computer after explicit opt-in, along with connected apps through Composio.
  • A complete team of bots can be installed from one Markdown file with YAML frontmatter, with connections left off until you approve them.
  • Voice output can use ElevenLabs, Fish Audio, Grok, built-in Mac voices or local Chatterbox, with cloud keys kept on the harness.

How milind-soni/openmausbot works

OpenMausBot runs as two processes. The chat app in src/ holds no transports of its own, sends typed commands over HTTP and folds the server's SSE event stream into its 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. server/drivers/ contains one driver per provider, covering Claude, Codex and Grok Build over their local CLIs, and an unknown driver is reported as unavailable instead of crashing the fleet. server/harness/ keeps the registry that maps configs to live instances and the event bus that clients read from. server/index.ts exposes bots, turns, approvals, connectors and configuration as HTTP and SSE endpoints, and electron/ wraps the app as a desktop shell for macOS, Windows and Ubuntu with an embedded harness server.

The codebase has 7,465 files and 59,503 symbols in 20 modules, led by TypeScript, JavaScript and Shell. Code health is 7.4 out of 10, rated good.