# milind-soni/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.

Source: https://github.com/milind-soni/openmausbot
Indexed: commit 57405b5 on 2026-11-17 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: App
- Language: TypeScript
- Stars: 26,679 at index time
- License: Apache-2.0
- Code health: 7.5/10, Good
- Last commit: 2026-11-16
- Contributors: 300

## Install

From the README: https://github.com/milind-soni/openmausbot#-install-a-complete-team-from-one-markdown-file

Clone the openmausbot repository.
    git clone https://github.com/milind-soni/openmausbot.git

Move into the openmausbot folder.
    cd openmausbot

Install the dependencies from a source checkout.
    pnpm install

Start the harness server on 127.0.0.1:8799.
    pnpm dev:server

Start the Electron desktop shell, keeping the two commands above running.
    pnpm dev:desktop

## How it 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.

- .tmpexp/run.mjs: entry point
- companion/src/index.ts: entry point
- connector/src/main.ts: entry point
- electron/main.mjs: entry point
- packages/phone-protocol/src/app.ts: entry point
Modules: server, src, electron, scripts, shared, packages, companion, cloudflare. 7,465 files, 1,079,366 lines, 59,503 symbols.

## Code health

- Score: 7.5/10 (Good)
- Trend: 7.0 on 2026-11-07, 7.5 on 2026-11-17
- Rank: #108 of 4,000+ indexed repos
- Hotspots: src/components/Sidebar.tsx, electron/main.mjs, server/index.ts, src/state/store.tsx, src/components/ChatView.tsx
- Lowest file: server/index.ts
- Dead code: 97 findings

## Maintenance

- Last commit 2026-11-16, first commit 2026-08-11, 7,970 commits
- 300 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/milind-soni/openmausbot/security

## More

- Page: https://repowise.dev/repo/milind-soni/openmausbot
- Ask this codebase: https://repowise.dev/repo/milind-soni/openmausbot/chat
- Docs: https://repowise.dev/repo/milind-soni/openmausbot/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/milind-soni/openmausbot
