Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents https://cmux.com
Find a file
2026-02-09 23:53:22 -08:00
.claude/commands Release v1.23.0 (#31) 2026-02-09 15:30:43 -08:00
.github/workflows Update landing page: switch to Bun, add view transitions and UI polish 2026-02-09 22:01:53 -08:00
Assets.xcassets Add dev build branding and reload scripts 2026-01-28 01:20:48 -08:00
CLI Keep legacy bundle ID for Sparkle updates 2026-02-09 15:50:42 -08:00
docs Release v1.23.0 (#31) 2026-02-09 15:30:43 -08:00
docs-site Release v1.24.0 (#32) 2026-02-09 16:13:26 -08:00
ghostty@4713b7e236 Update ghostty submodule workflow 2026-01-28 22:35:28 -08:00
GhosttyTabs.xcodeproj Release v1.24.0 (#32) 2026-02-09 16:13:26 -08:00
GhosttyTabsUITests Release v1.23.0 (#31) 2026-02-09 15:30:43 -08:00
homebrew-cmux@19af91f6d4 Release v1.23.0 (#31) 2026-02-09 15:30:43 -08:00
node_modules Update app and tooling 2026-01-29 17:36:26 -08:00
Resources Release v1.23.0 (#31) 2026-02-09 15:30:43 -08:00
scripts Release v1.23.0 (#31) 2026-02-09 15:30:43 -08:00
Sources Release v1.23.0 (#31) 2026-02-09 15:30:43 -08:00
tests Release v1.23.0 (#31) 2026-02-09 15:30:43 -08:00
web Fix blurry logo by skipping Next.js image optimization 2026-02-09 23:52:07 -08:00
.gitignore Add zig, node, and hypothesis to gitignore (#8) 2026-02-03 15:18:59 -08:00
.gitmodules Release v1.23.0 (#31) 2026-02-09 15:30:43 -08:00
.vercelignore Add Vercel ignore 2026-01-29 17:50:35 -08:00
AGENTS.md agents 2026-01-22 03:18:02 -08:00
bun.lock Update app and tooling 2026-01-29 17:36:26 -08:00
CHANGELOG.md Release v1.24.0 (#32) 2026-02-09 16:13:26 -08:00
CLAUDE.md Release v1.23.0 (#31) 2026-02-09 15:30:43 -08:00
cmux-Bridging-Header.h Rename to cmux and add About panel 2026-01-26 03:05:03 -08:00
CONTRIBUTING.md Release v1.23.0 (#31) 2026-02-09 15:30:43 -08:00
ghostty.h Initial commit: macOS terminal app with vertical tabs using libghostty 2026-01-22 01:16:24 -08:00
package.json Update app and tooling 2026-01-29 17:36:26 -08:00
Package.resolved Initial commit: macOS terminal app with vertical tabs using libghostty 2026-01-22 01:16:24 -08:00
Package.swift Rename to cmux and add About panel 2026-01-26 03:05:03 -08:00
README.md Update README install section to match docs 2026-02-09 23:53:22 -08:00
TODO.md Release v1.23.0 (#31) 2026-02-09 15:30:43 -08:00

cmux

A Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents

Download cmux for macOS

cmux screenshot

Features

  • Native macOS app — Built with Swift and AppKit, not Electron. Fast startup, low memory.
  • Vertical tabs — See all your terminals at a glance in a sidebar
  • Notification panel — See which agents are waiting for input at a glance
  • Notification rings — Tabs flash when AI agents (Claude Code, Codex) need your attention
  • Lightweight — Small binary, minimal resource footprint. No bundled browser engine.
  • GPU-accelerated — Powered by libghostty for smooth rendering

Install

Download for Mac

Open the .dmg and drag cmux to your Applications folder. cmux auto-updates via Sparkle, so you only need to download once.

Homebrew

brew tap manaflow-ai/cmux
brew install --cask cmux

To update later:

brew upgrade --cask cmux

On first launch, macOS may ask you to confirm opening an app from an identified developer. Click Open to proceed.

Why cmux?

Running multiple AI coding agents? cmux helps you manage them. Instead of losing track of which terminal needs input, the notification panel shows you exactly where to look.

A native macOS app means it launches instantly, uses minimal RAM, and feels right at home on your Mac.

Keyboard Shortcuts

Workspaces

Shortcut Action
⌘ N New workspace
⌘ 18 Jump to workspace 18
⌘ 9 Jump to last workspace
⌘ ⇧ W Close workspace

Surfaces

Shortcut Action
⌘ T New surface
⌘ ⇧ [ Previous surface
⌃ ⇧ Tab Previous surface
⌃ 18 Jump to surface 18
⌃ 9 Jump to last surface
⌘ W Close surface

Split Panes

Shortcut Action
⌘ D Split right
⌘ ⇧ D Split down
⌥ ⌘ ← → ↑ ↓ Focus pane directionally

Browser

Shortcut Action
⌘ ⇧ B Open browser in split
⌘ L Focus address bar
⌘ ] Forward
⌘ R Reload page
⌥ ⌘ I Open Developer Tools

Notifications

Shortcut Action
⌘ ⇧ I Show notifications panel
⌘ ⇧ U Jump to latest unread

Find

Shortcut Action
⌘ F Find
⌘ G / ⌘ ⇧ G Find next / previous
⌘ ⇧ F Hide find bar
⌘ E Use selection for find

Terminal

Shortcut Action
⌘ K Clear scrollback
⌘ C Copy (with selection)
⌘ V Paste
⌘ + / ⌘ - Increase / decrease font size
⌘ 0 Reset font size

Window

Shortcut Action
⌘ ⇧ N New window
⌘ , Settings
⌘ ⇧ R Reload configuration
⌘ Q Quit