Skip to content
Sign in
  • Browse all toolsFilter by category and pricing
  • Browse categoriesWriting, code, image, audio and more
  • Compare toolsPut up to three side by side
  • Read the blogGuides and comparisons

cmux

Open-source macOS terminal with workspaces, split panes, browser automation, and notifications for AI coding agents.

cmux is a free, open-source macOS terminal that combines workspace tabs, split panes, agent notifications, and a scriptable browser. Designed for developers running AI coding agents and parallel terminal sessions, cmux provides CLI and socket API controls and is available through DMG download or Homebrew under a GPL licence.

Updated 9 Nov 20266 sections

cmux website screenshot

What is cmux?

cmux is an open-source macOS terminal with an integrated browser, workspace management, and notifications for AI coding agents. Designed for developers handling parallel coding sessions, cmux brings terminal activity and agent attention signals into a native application. The project uses Swift and AppKit for the application and libghostty for terminal rendering.

cmux adds a sidebar that exposes context for each workspace rather than relying only on terminal tab titles. Workspace entries show git branches, linked pull request status and numbers, working directories, listening ports, and recent notification text. Existing Ghostty configuration supplies themes, fonts, and colors.

What cmux can do

cmux combines terminal organization with browser control and agent notifications. Developers can divide work across workspaces and splits, inspect project context in the sidebar, and identify sessions waiting for attention. The CLI and socket API expose controls for building custom workflows around these capabilities.

  • cmux highlights waiting agents with blue pane rings and illuminated tabs.
  • cmux collects pending notifications in a panel and jumps to the latest unread item.
  • cmux splits terminal and browser panes horizontally and vertically.
  • cmux lets agents inspect accessibility trees, click elements, fill forms, and evaluate JavaScript.
  • cmux imports browser cookies, history, and sessions from Chrome, Firefox, Arc, and other browsers.
  • cmux launches Claude Code teammates as native splits without tmux.
  • cmux runs project-specific commands defined in cmux.json.

How cmux works

cmux can be installed by opening the DMG and dragging the application into the Applications folder, or through the project's Homebrew tap and cask. The Homebrew cask installs shell completions for zsh, bash, and fish. Other installation methods require adding the matching completion command to the shell startup file.

cmux supports remote workspaces through its SSH command. Browser panes route through the remote network so remote localhost services are accessible, and dragging an image into a remote session uploads the image through scp. For agent notifications, cmux recognizes terminal notification sequences and provides a notify command that developers can connect to agent hooks.

Who cmux is for

cmux serves developers who prefer terminal-based coding workflows and need to organize multiple agents or projects on macOS. The repository describes parallel Claude Code and Codex sessions as a motivation for the project. Browser scripting, workspace metadata, and remote connections also support development tasks that cross terminal and web interfaces.

  • cmux helps developers track parallel coding-agent sessions across workspaces.
  • cmux lets Claude Code interact with a development server through a browser pane.
  • cmux supports remote development with SSH workspaces and remote browser routing.
  • cmux lets developers automate workspace creation, pane splitting, and keystroke delivery.

cmux pricing and installation options

cmux is free and GPL-licensed, with source code available in the public repository. The documented installation options are a recommended DMG download and Homebrew. The DMG installation auto-updates through Sparkle, while Homebrew users can update through the cask upgrade command.

cmux also offers a separate nightly application built automatically from the latest main commit. The nightly application has its own bundle identity and Sparkle update feed, allowing installation alongside the stable version. The repository directs nightly bug reports to GitHub Issues or the designated Discord channel.

cmux strengths and limitations

cmux brings workspace context, terminal splits, browser automation, and agent notifications into a native macOS application. Compatibility with existing Ghostty configuration supports familiar terminal styling. The project presents these capabilities as programmable building blocks rather than a prescribed agent workflow, leaving developers to compose their own automation.

  • cmux is a macOS application, so the documented desktop installation targets that operating system.
  • cmux requires hook configuration when developers connect its notify command to agent events.
  • cmux requires project-specific actions to be defined in cmux.json before those actions appear in the command palette.

cmux FAQ

What is cmux?

cmux is an open-source, Ghostty-based macOS terminal for developers working with AI coding agents. cmux combines vertical workspace tabs, terminal splits, agent notifications, and an in-app browser with CLI and socket API controls for custom automation.

Is cmux free?

cmux is free and GPL-licensed. cmux is available through a DMG download or Homebrew, with source code in the public repository. The DMG installation supports automatic updates through Sparkle, and a separate nightly application is also available.

Does cmux support Claude Code?

cmux supports Claude Code workflows through agent notification hooks, browser interactions, and Claude Code Teams. The cmux claude-teams command launches teammate mode with teammates displayed as native splits, including sidebar metadata and notifications, without requiring tmux.

Does cmux have an API for automation?

cmux provides a CLI and socket API for creating workspaces, splitting panes, sending keystrokes, and controlling the browser. The browser API supports accessibility-tree snapshots, element references, clicks, form filling, and JavaScript evaluation.

Can cmux connect to remote machines over SSH?

cmux creates remote workspaces through its SSH command and can run an initial command in the first remote terminal. Browser panes use the remote network, and dragging an image into a remote session uploads the image through scp.

From the community

No reviews yet

Be the first to review this tool. What you write helps the next person choose.

More tools like cmux

Agent of Empires

www.github.com

Manage parallel AI coding agents through persistent terminal sessions, a web dashboard, and mobile browser access.

Free

orca

www.github.com

Run coding agents in parallel with isolated worktrees, chat, terminals, code review, and remote access.

Free

BossConsole

www.github.com

Open-source desktop workspace for AI agents with a browser, terminal, editor, plugins, and MCP tools.

Free

tuios

www.github.com

An open-source terminal multiplexer with tiled panes, persistent sessions and a shared inbox for coding agents.

Free