manaflow-ai/cmux

What it solves

cmux is a native macOS terminal designed specifically for developers who work with multiple AI coding agents in parallel. It solves the problem of losing track of which agent needs attention across numerous open tabs and split panes, and the limitation of generic terminal notifications that lack context.

How it works

Built with Swift and AppKit using the libghostty rendering engine, cmux provides a high-performance terminal environment. It integrates a notification system that detects terminal escape sequences (OSC 9/99/777) or uses a dedicated CLI (cmux notify) to highlight panes with blue rings and light up sidebar tabs when an agent is waiting for input. It also includes a scriptable in-app browser that agents can control via a socket API to verify web changes in real-time.

Who it’s for

Developers using terminal-based AI coding agents (such as Claude Code, Codex, OpenCode, Aider, or Goose) who need a specialized workspace to manage multiple concurrent sessions and automate their browser interactions.

Highlights

• Agent-Centric Notifications: Visual cues like notification rings and a dedicated panel to quickly jump to agents needing attention.
• Programmable Interface: A CLI and socket API to automate workspace creation, pane splitting, and browser control.
• Integrated Browser: A scriptable browser pane that can be controlled by agents to snapshot the DOM, click, and evaluate JavaScript.
• Native macOS Performance: Built as a native app (not Electron) for fast startup and low memory usage, while remaining compatible with Ghostty configurations.
• Session Restore: Automatically restores window layouts, working directories, and supported agent sessions upon relaunch.
• SSH and Remote Support: Native SSH workspaces that route browser panes through the remote network.