Features in Detail

AgentMux packs serious capability into 150-350MB of memory. Here's everything it can do.

Agent

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
Agent

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
Agent

Forge Orchestration

Create, configure, and launch agents from a built-in agent picker wired to a SQLite-backed agent database.

  • +Agent picker with inline list, create/edit forms, and emoji icons for visual identity
  • +Provider config - specify CLI command, args, and output format per agent
  • +Auto-seeds with your container agents on first launch
  • +Real-time sync via WPS events keeps picker in sync when agents change
  • +One-click agent spawning from picker into any pane
Agent

Agent CLI Install & Streaming

Install agent CLIs directly from AgentMux. Structured stream parsing with a rich presentation layer.

  • +Built-in installer for supported agent CLI 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
Observability

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
Observability

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
Observability

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
Architecture

Interpane 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
Platform

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 sub-millisecond WebSocket channels
  • +Reactive injection endpoints for cross-host agent coordination
  • +Audit endpoint logs all agent injections for compliance and debugging
Platform

Shell Integration (wsh)

1.1MB Rust binary deployable to remote hosts. Auto-deployed shell hooks for bash, zsh, fish, and PowerShell.

  • +Identifies running pane via AGENTMUX_BLOCKID and AGENTMUX_TABID env vars
  • +Working directory tracking via OSC 7 sequences
  • +Multi-strategy binary discovery - portable > installed > PATH search
  • +Self-healing version guards detect stale hooks and rebuild automatically
  • +OSC 16162 custom escape sequence for agent configuration
Performance

100% Rust Backend

Tokio + Axum + SQLite. 4.4MB binary. 3.6x lower memory than Go. 19-44% faster latency. Zero GC pauses.

  • +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, Forge agents, and config
  • +Battle-tested: AgentMux was built by agents running in AgentMux
Performance

Stable Memory for Long Sessions

Chromium 146 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 146 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)
Performance

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 (10 req/sec) for DoS protection on injection endpoints

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
Workspace

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
Workspace

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
Workspace

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. ~152MB 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

View on GitHub