ai-setup 5 min read

cmux: A macOS Terminal Built for Parallel Coding Agents

cmux is a Ghostty-based macOS terminal with vertical tabs, notifications, and programmability aimed at running multiple AI coding agents at once.

By
Share: X in
GitHub social preview card for manaflow-ai/cmux

TL;DR: cmux is a macOS terminal built on Ghostty that adds vertical tabs and notifications so you can run several AI coding agents side by side. It is aimed at people who keep four or five terminal sessions open and lose track of which one is doing what.

What it is

cmux describes itself as an open source Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents. The repository lists the intent plainly: multitasking, organization, and programmability.

That positioning matters because the terminal multiplexer category already has a default answer. tmux is everywhere, and it runs everywhere. cmux is narrower. It is a Mac app, it uses Ghostty as its rendering layer, and it is organized around the specific problem of supervising several agent sessions rather than around generic remote shells.

The project is Swift, sits under the manaflow-ai organization, and publishes to cmux.com. It has been pushed to within hours of this writing, so the main branch is moving fast.

What the numbers say

MetricValue
Stars27,863
Forks2,463
Open issues3,223
LanguageSwift
Created2026-01-28
Last push2026-10-08

The star-to-issue ratio is worth pausing on. Roughly one open issue per eight stars points to a project that attracts interest faster than it absorbs it. The topic list is long and specific, including claude-code, codex, gemini, opencode, amp, ghostty, multiplexer, tmux, terminal-multiplexer, workspace-manager, parallel-agents, and programmability. Those tags tell you what the author is positioning against: both the coding agents you run inside and the multiplexer you already run them under.

One caveat on licensing. The GitHub API reports the license as NOASSERTION, meaning the repo has a license file that GitHub cannot classify automatically. Check the LICENSE file in the repo before you build on it. Treat the terms as unknown rather than assuming a permissive grant.

What it does well

Vertical tabs are the specific answer to a specific failure. When you run five agents in one window, the tab strip becomes the thing you look at hundreds of times a day. Side tabs scale differently than top tabs, which is not a cosmetic preference when you are switching between sessions constantly.

Notifications matter more here than in an ordinary terminal. An agent run is asynchronous by nature. You prompt it, you go work on something else, and it finishes on its own schedule. A terminal that tells you which session just went idle removes the polling loop.

Programmability is listed in the description, and the topic tags include cli and workspace-manager. A terminal that other tools can drive fits the agent workflow better than one you can only click.

How to try it

This is a native macOS app rather than a build-from-source library, so the realistic path is downloading the release and running it. Build from source if you want to track main:

git clone https://github.com/manaflow-ai/cmux.git
cd cmux
# follow the repo's own build instructions for the macOS app target

Once it is open, the workflow it is designed around looks like this:

# start an agent session in its own tab
claude

# open another tab for a second agent
codex

Keep both running, use vertical tabs to see status at a glance, and let notifications tell you when one returns. That is the loop the project is built around.

When to use it

If you are running two or more coding agents in parallel on a Mac today, cmux is worth trying. The vertical tab and notification combination is a real answer to a real daily annoyance, and the star count says a lot of people arrived at the same conclusion.

It also makes sense as a Ghostty-based option if you have already moved to Ghostty for rendering speed and want the same GPU-accelerated feel with agent-oriented session management on top.

When not to use it

Skip it if you work on Windows or Linux. This is a macOS app built in Swift, not a cross-platform tool.

Skip it if your workflow is one terminal, one agent, one task. The value comes from supervising multiple sessions. With one session running, vertical tabs and notifications add interface you do not use.

Be cautious if you need a stable API surface today. With 3,223 open issues and daily pushes to main, expect churn in menus, configuration keys, and CLI flags. Read release notes before scripting against it.

Source and Accuracy Notes

  • Project page: https://github.com/manaflow-ai/cmux
  • Source repository: manaflow-ai/cmux (verified via GitHub API html_url)
  • License: NOASSERTION (verified via GitHub API license.spdx_id, means GitHub could not classify the license file automatically; check the repo LICENSE before use)
  • Stars at time of writing: 27,863
  • Homepage referenced in this post: https://cmux.com (verified via GitHub API homepage)
  • GitHub API was queried unauthenticated for this post; the environment’s GITHUB_TOKEN returned HTTP 401