repowisemilind-soni/openmausbot

Architecture of milind-soni/openmausbot

milind-soni/openmausbot is 7,465 source files holding 59,503 symbols across 20 modules, written mainly in TypeScript, JavaScript, Shell. The largest module is server, with 3,297 files, and 16 files are entry points into the dependency graph.

How openmausbot fits together

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.

Largest modules

  • server: 3,297 files and 610,359 lines of code
  • src: 2,115 files and 262,985 lines of code
  • electron: 526 files and 81,635 lines of code
  • scripts: 333 files and 48,251 lines of code
  • shared: 260 files and 13,439 lines of code
  • packages: 94 files and 7,285 lines of code
  • companion: 77 files and 14,054 lines of code
  • cloudflare: 67 files and 16,895 lines of code

Languages

By file count: TypeScript 6,321 files, JavaScript 586 files, Shell 11 files, Dockerfile 5 files, Python 1 file, Swift 1 file.

Documentation

Repowise documents openmausbot in 5,082 pages generated from the source, 43 of them written explanations of the repository and its modules. Module guides include:

  • server/drivers/acp: ACP Driver Implementations

More on openmausbot: summary and FAQ, codebase overview, code health.

Related guide: Best dependency graph tools for monorepos