Skip to content
AgentMux

Getting Started with AgentMux

AgentMux is an agent operating environment — a desktop app where AI agents are first-class residents: structured panes with real identity, real memory, and the ability to operate the workspace itself. Built on Rust with a bundled Chromium 148 via CEF and a SolidJS frontend.

What is AgentMux?

Section titled “What is AgentMux?”

In AgentMux, every agent is a first-class resident — not a terminal wrapper, but a structured pane with its own identity bundle, memory bundle, streaming parser, and lifecycle. Nine providers run as first-class agent types: Claude Code, Codex CLI, Mux Code, Gemini CLI, Qwen Code, Kimi Code CLI, OpenClaw, Pi, and GitHub Copilot CLI. You see every tool call, file write, and network request in real time. And uniquely: agents can operate the environment itself via the Agent App API — opening panes, renaming tabs, messaging peer agents, navigating the workspace.

Key Concepts

Section titled “Key Concepts”
  • Panes — Individual workspace units. Each pane has a type (agent, browser, terminal, editor, swarm, drone, sysinfo, warden, help).
  • Self-contained — AgentMux bundles its own Chromium runtime and installs the agent CLIs for you on first use (in-pane install modal, per-version cache). No npm install -g step before launch.
  • Identity bundles — Named credential sets (GitHub PAT, AWS profile, Anthropic API key, …) you assign to an agent at launch. Survives renames; swappable without restart.
  • Bundles (formerly Memory bundles/Presets) — Reusable agent personality + capability stacks (provider, model, instructions, MCP, skills). Manage app-wide from the Armory’s Bundles tab.
  • Interagent Comms — Agents communicate via the MuxBus (Host / LAN / WAN tiers). Use DiscoverAgents to find peers and SendMessage to send typed messages. An agent’s output can also stream into another pane’s input.
  • Agent App API — Agents inside any pane can control the workspace via a typed MCP + REST API: open new panes, rename tabs and windows, navigate between tabs, discover and message peer agents. This is what makes AgentMux an operating environment, not just a workspace. See Agent App API.
  • Subagent monitoring — The Swarm pane provides a bird’s-eye view of all sub-agents spawned by primary agents; clicking one opens a focused Subagent view.
  • Toolchain Manager — Hamburger menu (≡) → Toolchain Manager shows the effective PATH and the detected version, path, and status of every provider CLI and system dependency, with install links for anything missing.
  • Reducer stack — A 4-layer audited dispatch model (launcher / host / sidecar / frontend slices). Every state mutation is structured and logged.

Quick Install

Section titled “Quick Install”

macOS (Apple Silicon)

Section titled “macOS (Apple Silicon)”

Download the .dmg from agentmux.ai or the GitHub releases.

Windows

Section titled “Windows”

Download the installer (.exe) or portable (.zip) from agentmux.ai.

Linux

Section titled “Linux”

Download the AppImage from agentmux.ai:

Terminal window
chmod +x AgentMux_amd64.AppImage
./AgentMux_amd64.AppImage

Next Steps

Section titled “Next Steps”