Developer Tools

cmux
Cheat Sheet

Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents. Built for running multiple Claude Code sessions simultaneously.

macOS
Getting Started

Quick Start

1

Install

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

or download DMG from GitHub Releases

2

Launch

cmux

Opens with vertical tabs sidebar

3

Start Claude Code

claude

Run in each tab — cmux shows notifications when Claude needs attention

Reference

Keyboard Shortcuts

Workspaces

⌘ NNew workspace
⌘ 1–8Jump to workspace 1–8
⌘ 9Jump to last workspace
⌃ ⌘ ]Next workspace
⌃ ⌘ [Previous workspace
⌘ ⇧ WClose workspace
⌘ ⇧ RRename workspace
⌘ BToggle sidebar

Surfaces (Tabs)

⌘ TNew surface (tab)
⌘ ⇧ ]Next surface
⌘ ⇧ [Previous surface
⌃ TabNext surface
⌃ ⇧ TabPrevious surface
⌃ 1–8Jump to surface 1–8
⌃ 9Jump to last surface
⌘ WClose surface

Split Panes

⌘ DSplit right
⌘ ⇧ DSplit down
⌥ ⌘ ←→↑↓Focus pane directionally
⌘ ⇧ HFlash focused panel

Browser Pane

⌘ ⇧ LOpen browser in split
⌘ LFocus address bar
⌘ [Back
⌘ ]Forward
⌘ RReload page
⌥ ⌘ IToggle Developer Tools
⌥ ⌘ CShow JavaScript Console

Notifications & Find

⌘ IShow notifications panel
⌘ ⇧ UJump to latest unread
⌘ FFind
⌘ GFind next
⌘ ⇧ GFind previous
⌘ ⇧ FHide find bar
⌘ EUse selection for find

Terminal & Window

⌘ KClear scrollback
⌘ CCopy (with selection)
⌘ VPaste
⌘ +Increase font size
⌘ -Decrease font size
⌘ 0Reset font size
⌘ ⇧ NNew window
⌘ ,Settings
⌘ ⇧ ,Reload configuration
CLI

CLI Commands

Install & Update

brew tap manaflow-ai/cmuxAdd cmux tap
brew install --cask cmuxInstall via Homebrew
brew upgrade --cask cmuxUpdate to latest

Usage

cmuxLaunch cmux terminal
cmux notifyWire agent hooks for notifications
cmux ssh user@remoteCreate remote workspace
cmux claude-teamsLaunch Claude Code teammate mode
Features

Key Features

Vertical TabsCore

Sidebar hiển thị git branch, PR status, directory, listening ports, và notification text cho từng tab.

NotificationsAI Agents

Blue rings khi Claude cần attention. Panel tập trung tất cả alerts. ⌘ ⇧ U nhảy đến unread mới nhất.

Split PanesCore

Chia màn hình horizontal & vertical. Chạy nhiều Claude Code sessions cùng lúc trong một workspace.

Browser PaneBuilt-in

In-app browser với scriptable API. Import cookies, history từ Chrome, Firefox, Arc, và 20+ browsers.

SSH WorkspacesRemote

cmux ssh user@remote tạo remote workspace. Làm việc trên server như local.

Session RestoreProductivity

Khôi phục layout, directories, scrollback, browser history. Chỉ live processes (Claude Code, vim) cần restart.

Custom CommandsConfig

Định nghĩa project-specific actions trong cmux.json. Scriptable CLI/Socket API cho automation.

Ghostty ConfigConfig

Đọc ~/.config/ghostty/config cho themes, fonts, colors. GPU-accelerated rendering.

Workflow

Why cmux + Claude Code?

Multi-agent workflow with cmux
$ cmux
# Launch cmux — vertical tabs sidebar
⌘ ⌘T → Tab 1: cd frontend && claude
# Claude Code cho frontend
⌘ ⌘T → Tab 2: cd backend && claude
# Claude Code cho backend
⌘ ⌘⇧L → Tab 3: browser pane (localhost:3000)
# Built-in browser preview
! Blue ring notification: Tab 1 needs attention
# ⌘⇧U nhảy ngay đến tab cần attention
> Review diff → Y → quay lại Tab 2
# Sidebar hiển thị git branch + PR status cho mỗi tab
1

Parallel sessions

Chạy nhiều Claude Code sessions song song. Mỗi tab hiện git branch, directory, status riêng biệt.

2

Smart notifications

Khi Claude dừng chờ input, cmux hiện blue ring notification. Không cần liên tục check từng tab.

3

Built-in browser

Preview app ngay trong terminal. Import sessions từ Chrome/Arc. DevTools tích hợp sẵn.

4

Session restore

Khôi phục toàn bộ layout khi reopen. Directories, scrollback, browser history — chỉ cần restart Claude Code.

Setup

Configuration

Ghostty ConfigThemes

cmux reads Ghostty config for themes, fonts, and colors.

~/.config/ghostty/config
cmux.jsonProject

Project-specific custom commands and actions.

./cmux.json
Session RestoreAuto

Preserves layout, directories, scrollback, browser history.

Window/workspace/pane layout
Working directories
Terminal scrollback
Browser URL & history
Auto UpdateSparkle

DMG auto-updates via Sparkle. Homebrew via brew upgrade.

brew upgrade --cask cmux
Session

Session Restore

Restored

Window/workspace/pane layoutYes
Working directoriesYes
Terminal scrollbackBest effort
Browser URL & historyYes

NOT Restored

Live process state (Claude Code, vim)No
tmux sessionsNo

Tip: Dùng claude -c để continue Claude Code session sau khi restore.