Skip to content
AgentMux

Internals

The Internals section is for two audiences:

  • Contributors — anyone working on the AgentMux codebase. The architecture, reducer model, and persistence layer are documented here.
  • Integrators — anyone building external tools that drive AgentMux through its RPC surface. MuxAPI and generated TypeScript / Rust references are here.

AgentMux runs as four processes. Architecture overview explains each one:

The four processes: agentmux-launcher (one per channel) starts agentmux-cef, the host that embeds Chromium, and agentmux-srv, the backend. The SolidJS frontend runs in the main renderer and talks to srv over a WebSocket.

Architecture overview

The four-process topology — launcher / host / sidecar / renderer — and how they communicate.

Architecture →

The reducer stack

AgentMux’s audited-dispatch model: every state mutation goes through one layer’s reducer and is logged.

Reducer stack →

Build from source

Prerequisites (CMake + Ninja for cef-dll-sys), repo layout, build commands, debugging.

Building →

MuxAPI

Drive AgentMux from an external agent or tool: open panes, send messages, read output. JSON-RPC over WebSocket.

MuxAPI →

Contributing

Section titled “Contributing”

Please read the Contributing guide before opening a PR.