Internals

Alpha Software

AgentMux is in early alpha and under heavy active development. Internals are evolving — pages here describe the current architecture and may be revised as the codebase changes. For the user-facing surface, see the User Guide.

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. The Agent App API and generated TypeScript / Rust references are here.

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 →

Agent App API

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

Agent App API →

Contributing

Please read the Contributing guide before opening a PR.