jleechanorg/cmux

Analysis updated 2026-08-08 · repo last pushed 2026-07-27

SwiftAudience · developerComplexity · 3/5ActiveSetup · moderate

Mindmap

mindmap
  root((repo))
    What it does
      Tracks multiple AI agents
      Visual sidebar for tabs
      Highlights agent needing input
    Tech stack
      Swift
      macOS native
      Ghostty terminal engine
    Key features
      Split screen terminals
      Built-in web browser
      SSH remote connections
      Session restore
    Use cases
      Run AI coding agents
      Monitor agent notifications
      Remote server development
    Audience
      Developers
      Technical founders
      Terminal power users

mindmap root((repo)) What it does Tracks multiple AI agents Visual sidebar for tabs Highlights agent needing input Tech stack Swift macOS native Ghostty terminal engine Key features Split screen terminals Built-in web browser SSH remote connections Session restore Use cases Run AI coding agents Monitor agent notifications Remote server development Audience Developers Technical founders Terminal power users

What do people build with it?

USE CASE 1

Run multiple AI coding agents side by side and get visual alerts when one needs your input.

USE CASE 2

Split your terminal screen to watch several AI sessions simultaneously while keeping them organized.

USE CASE 3

SSH into a remote server and use the routed browser to interact with local websites from that connection.

USE CASE 4

Restore your previous terminal session after quitting, with tabs and history exactly as you left them.

What is it built with?

SwiftmacOSGhostty

How does it compare?

	jleechanorg/cmux	0xsmw/pixelcop	aiduckman/claudeusage_latest_may2026
Stars	—	—	0
Language	Swift	Swift	Swift
Last pushed	2026-07-27	2026-07-24	—
Maintenance	Active	Active	—
Setup difficulty	moderate	easy	easy
Complexity	3/5	2/5	2/5
Audience	developer	designer	vibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires macOS and familiarity with terminal-based workflows, you need to have AI coding agents like Claude Code or Codex installed to get full value.

No license information was provided in the explanation, so usage rights are unknown.

In plain English

cmux is a Mac terminal app designed specifically for people who run multiple AI coding agents (like Claude Code or Codex) at the same time. If you have ever had several AI sessions running in separate tabs and missed an important notification because they all just said "waiting for input," this tool solves that problem. It gives you a visual sidebar to track everything and highlights exactly which AI agent needs your attention. At its core, the app is a fast, native Mac terminal built on top of a popular terminal engine called Ghostty. It uses a vertical sidebar to organize your tabs, showing useful context for each session like the current git branch, open ports, and the latest notification text. When an AI agent needs you, the corresponding pane gets a blue ring and its tab lights up. You can split your screen to view multiple terminals at once, or even open a built-in web browser next to your terminal so an AI agent can directly interact with a local website. The tool is built for developers and technical founders who live in the terminal but want better visual management of their AI workflows. For example, if you are running a team of AI coding agents simultaneously, this app can spawn them all in organized splits and alert you when specific ones finish. It also includes an SSH feature that lets you connect to remote servers, complete with a routed browser so that local web links work smoothly on the remote machine. Additionally, it can restore your previous session if you quit, reopening your tabs and terminal history exactly as you left them. What makes this project notable is its philosophy and performance. The creator deliberately avoided using web-based frameworks like Electron to keep the app fast and lightweight. Instead, it is built natively for macOS using Swift. The project's overarching philosophy is to act as a set of building blocks rather than a rigid system. It provides the terminal, the browser, the notifications, and a command-line interface, leaving you to figure out the best way to manage your AI agents.

Copy-paste prompts

Prompt 1

I want to set up cmux to run three Claude Code agents in split panes. Help me configure the splits and understand how the notification system will alert me when one needs input.

Prompt 2

Help me use cmux's SSH feature to connect to a remote server and route the built-in browser so I can view a web app running on that remote machine.

Prompt 3

I have cmux installed on my Mac. Walk me through organizing my AI coding agent tabs using the sidebar, including how to read git branch info and port numbers for each session.

Prompt 4

Explain how cmux's session restore works so that when I quit and reopen, all my terminal tabs and scrollback history come back exactly as they were.

Frequently asked questions

What is cmux?

A native Mac terminal app for running multiple AI coding agents at once, with a visual sidebar that tracks each session and alerts you when an agent needs your attention.

What language is cmux written in?

Mainly Swift. The stack also includes Swift, macOS, Ghostty.

Is cmux actively maintained?

Active — commit in last 30 days (last push 2026-07-27).

What license does cmux use?

No license information was provided in the explanation, so usage rights are unknown.

How hard is cmux to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is cmux for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.