Features in Detail
AgentMux packs serious capability into 150-350MB of memory. Here's everything it can do.
Multi-Provider Agent Panes
Native pane type for Claude, Codex, and Gemini. Not a terminal wrapper - a purpose-built agent UI.
- +Structured view of tool calls, file edits, and reasoning with full markdown rendering
- +Stream-JSON parser renders agent output in real time as tokens arrive
- +Document model for hierarchical message blocks - diffs, terminal output, code blocks
- +OAuth integration with in-app authentication flow and visual overlay
- +Agent state machine manages connection lifecycle (idle, connecting, authorized, running)
- +Session persistence across pane moves and app restarts
Subagent Watcher
Monitor sub-agents spawned by your primary agent. See multi-level agent hierarchies in real time.
- +Auto-detects spawned sub-agents via JSONL output monitoring
- +Dedicated pane view per subagent with live streaming
- +Track multi-level agent hierarchies - see which subagent is doing what
- +Bootstrap output surfacing shows each agent's initial reasoning and task breakdown
Memory bundles
Reusable agent definitions — provider, model, instructions, MCP servers, skills, environment. Create once, launch many.
- +Agent picker with inline list, create/edit forms, and emoji icons for visual identity
- +Provider config - specify launch command, args, and output format per Memory bundle
- +v7 schema: Memory bundles stored in `db_memories` with FK from running agent instances
- +Real-time sync via WPS events keeps picker in sync when bundles change
- +One-click launch: pick a Memory + Identity, spawn into any pane
Reusable Identity bundles
Named credential sets — GitHub PAT, AWS profile, API keys, custom env — that survive across agent renames and can be swapped at launch.
- +Per-provider bindings: one credential per provider per Identity bundle
- +v7 schema: `db_identities` + `db_identity_bindings` junction to credential records
- +Singleton blank Identity for vanilla launches with no overrides
- +Spawn-time env injection — credentials applied as the agent process boots
- +Swap Identity on a running agent: re-injects env on next turn
Agent Install & Streaming
Install agents directly from AgentMux. Structured stream parsing with a rich presentation layer.
- +Built-in installer for supported agent providers
- +Streaming parser for structured tool calls and reasoning output
- +Agent presentation layer renders rich content in real time
- +Status bar integration shows agent name, activity badge, and color coding
Agents Regress. You'll Know.
Watch every tool call and decision step as it happens. Catch an agent undoing correct work mid-task.
- +Real-time streaming of every tool call with arguments and results
- +Visual diff overlay shows file changes as agents make them
- +Regression detection highlights when an agent reverts previous correct work
- +One-click interrupt redirects an agent mid-task without killing the session
- +Full session history with search - find exactly when and why an agent went off track
Multi-Agent View
Run parallel agents and see all of them at once. Spot conflicts before synthesis.
- +Side-by-side agent panes with independent scrolling
- +Conflict detection when agents modify the same files
- +Per-agent resource usage and progress indicators via status bar
- +Redirect or pause any agent without affecting others
- +Per-agent color coding via environment variables for visual identity
Live System Metrics
Dedicated sysinfo pane with real-time CPU, memory, and network graphs. Status bar with live uptime and agent activity.
- +Real-time CPU, memory, and network I/O graphs via Recharts
- +Process list with filtering and resource breakdown
- +Configurable history buffer for scrollback on metric graphs
- +Live status bar with uptime counter, backend health, and connection count
- +Per-pane stats and agent activity indicators at a glance
Interagent Reactive Communication
Panes talk to each other via Tokio channels. Build reactive pipelines where agent A's output triggers agent B.
- +Connect pane outputs to other pane inputs for event-driven workflows
- +WebSocket event system (WPS broker) for real-time pub/sub object updates
- +Visual connection indicators show active data flows between panes
- +Agent auto-registration - panes auto-register on backend with capability advertising
- +Offline queue - messages buffer when agents are offline, deliver on reconnect
Agent App API
Agents call a typed API to spawn panes, update titles, render dashboards, and modify the workspace.
- +Spawn new panes programmatically - terminal, editor, webview, dashboard
- +Self-modify pane layout, title, and status indicators from agent code
- +Full IPC bridge to the Rust backend via low-latency WebSocket channels
- +Reactive injection endpoints for cross-host agent coordination
- +Audit endpoint logs all agent injections for compliance and debugging
Shell Integration
Per-pane shell hooks for bash, zsh, fish, and PowerShell. Auto-deployed by the host so every terminal pane is self-aware.
- +Identifies the running pane via AGENTMUX_BLOCKID and AGENTMUX_TABID env vars
- +Working directory tracking via OSC 7 sequences
- +muxlog helper resolves the right host / sidecar log file from any context
- +Per-instance auth-dir isolation: each provider's *_HOME / *_CONFIG_DIR points at <instance>/config/auth/
100% Rust Backend
Tokio + Axum + SQLite. Compact sidecar binary. Zero GC pauses, zero heap growth over time.
- +Rust's ownership model - no null pointer crashes, no memory leaks
- +Auto-spawned sidecar binary, version-isolated from the CEF host
- +WebSocket WPS broker for real-time pub/sub event distribution
- +SQLite persistence for workspaces, blocks, tabs, Memory bundles, and config
- +Battle-tested: AgentMux was built by agents running in AgentMux
Stable Memory for Long Sessions
Chromium 148 via CEF — consistent rendering everywhere. Pure Rust backend with zero GC means no heap growth over time.
- +150-350MB at idle — comparable to Warp, far below Cursor or Windsurf
- +Rust backend memory is flat: what you see at startup is what you see after 8 hours
- +Chromium 148 bundled via CEF — identical behavior on Windows, macOS, and Linux
- +26MB frontend bundle via font optimization, worker dedup, and lazy loading
- +Shiki code highlighter lazy-loaded on demand (9.4MB deferred)
Sub-Millisecond IPC
Push-based WebSocket channels. Zero-copy serialization. Scales to hundreds of concurrent tool calls per second.
- +Agent output renders with no perceptible lag even under heavy multi-agent load
- +Tokio async runtime - no threads blocked, no UI frozen
- +EventBus bridge routes broker events to WebSocket clients in real time
- +Debounced metadata writes and throttled render calls prevent CPU spikes
- +Rate limiting on injection endpoints for DoS protection
Code Preview Pane
View files with syntax highlighting directly in a pane. Auto-detected language support from file extension.
- +Open any file on disk for viewing with syntax highlighting
- +Auto-detected language from file extension
- +Integrated with Agent App API for agent-spawned preview panes
Real PTY Terminal
Authentic terminal emulation via xterm.js + portable-pty. Not a pseudo-terminal - actual OS PTY with full ANSI support.
- +Full ANSI color, mouse support, and configurable scrollback
- +Per-pane font size, theme, and transparency via context menu
- +Working directory tracking and display via shell hooks
- +Copy/paste context menu with xterm.js selection awareness
Embedded Webview
Full web browser in a pane with navigation controls and independent zoom.
- +0.1x-5.0x zoom range independent of terminal zoom
- +URL and navigation state persisted across pane moves
- +Back/forward/reload controls in pane header
- +Isolated frame rendering for security
Multi-Window & Multi-Instance
Multiple windows with independent workspaces. Version-isolated instances. Cross-window drag and drop.
- +Drag panes across windows - PTY sessions and agent state survive the move
- +Tear off a pane to create a new window at cursor position
- +Instance indicator in title bar - (1), (2) for visual distinction
- +Shared settings across instances with file-watcher sync
- +Per-window saved geometry (size and position)
Cross-Platform Desktop
Native builds for Windows, macOS, and Linux. Code-signed and notarized where required.
- +macOS: .dmg with Apple code signing and notarization (ARM64 + Intel)
- +Windows: NSIS installer + portable ZIP (no certificate required)
- +Linux: AppImage + .deb package
- +Platform-native window controls, keyboard shortcuts, and menu bar
- +Auto-update system with opt-in, progress UI, and release notes
Per-Pane Zoom & Magnify
Independent 50-200% zoom per pane. Double-click to magnify any pane to full screen.
- +Zoom stored in block metadata - persists across sessions
- +Context menu submenu with 25% increment presets and reset option
- +Transient visual indicator shows current zoom level (1.5s fade)
- +Scroll position restored after zoom change
Reactive Settings
Settings apply instantly across all panes. File-watcher broadcasts changes. No restart needed.
- +Window opacity, transparency, and blur effects with real-time preview
- +Jotai atoms auto-update on config change via WebSocket event
- +Programmatic updates via RpcApi.SetConfigCommand for agent-driven config
- +Connection-level overrides cascade: block meta > connection > global
Drag & Drop Everything
Drag files into panes, reorder panes within tabs, move panes across windows, tear off tabs to new windows.
- +Drop files on agent panes to feed context or on terminals to copy to CWD
- +Intra-tab splits - drag pane left/right/up/down within same tab
- +Cross-tab and cross-window pane transfer with process continuity
- +Tab reordering, tear-off, and cross-window tab moves
- +Widget bar drag to reorder header widgets with persistence
Open Source · Apache 2.0
No telemetry, no tracking, no phone-home. Runs locally. Your agent data never leaves your machine.
- +Full source code on GitHub under Apache 2.0
- +No account required - works fully offline
- +Privacy-first: local agent state stays local (cloud bridge optional)
- +Use commercially without restriction
Try AgentMux
Free and open source. ~160MB portable — no install needed.
Early alpha. Features may be incomplete or unstable. AI agents generate content that may be inaccurate — always review outputs. Report issues