AgentLayerdocs
Workstation

cmux

A native-Mac terminal built on Ghostty for running many agents at once, with a sidebar that shows who is waiting.

cmux renders through libghostty and reads your existing Ghostty config, so the look and keybindings carry straight over. It is built for the parallel-agent era: instead of one terminal with one session, you get workspaces in a vertical sidebar, each showing its git branch, PR status, working directory, and the latest agent notification.

Why it fits Kevin

  • One workspace per agent task. Kevin in one, a coding agent in another, a long research run in a third. Split panes within a workspace for editor, logs, and agent.
  • Notifications that tell you who is waiting. When an agent finishes or needs input, its pane rings and the sidebar tab lights up. You know which of your six running agents wants attention without staring.
  • Organize like a file system. Group workspaces into folders, colour-code by project, and the sidebar becomes a live map of everything in flight.
  • Session restore. Layouts, directories, and scrollback survive closing the lid.

Pairing with worktrees and Kevin

One workspace per worktree, one agent per workspace. See Worktrees.

Kevin's where-am-i skill reads cmux's structured state where it is available, so the session radar can say which workspace a session lives in rather than guessing from rendered text.

Launch from the home

A multiplexer that opens workspaces at repo paths will start sessions outside the agent home, and those sessions are not captured. Open the Kevin workspace at ~/Documents/Agents/Kevin and reach repos through additionalDirectories. See Onboarding.

cmux is open source (AGPL-3.0, by Manaflow AI).

On this page