manaflow-ai/cmux

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/manaflow-ai/cmux.svg?style=card)](https://bestofgithub.dev/repo/manaflow-ai/cmux)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/manaflow-ai/cmux.svg)](https://bestofgithub.dev/repo/manaflow-ai/cmux)

Loading README…

Notification rings Panes get a blue ring and tabs light up when coding agents need your attention
Notification panel See all pending notifications in one place, jump to the most recent unread
In-app browser Split a browser alongside your terminal with a scriptable API ported from agent-browser
Vertical + horizontal tabs Sidebar shows git branch, linked PR status/number, working directory, listening ports, and latest notification text. Split horizontally and vertically.
SSH `cmux ssh user@remote` creates a workspace for a remote machine. Pass `--command 'omp "investigate auth"'` to run an initial command once in its first remote terminal. Browser panes route through the remote network so localhost just works. Drag an image into a remote session to upload via scp.
Claude Code Teams `cmux claude-teams` runs Claude Code's teammate mode with one command. Teammates spawn as native splits with sidebar metadata and notifications. No tmux required.

Shortcut	Action
⌘ N	New local workspace
⌘ Y	New Cloud workspace on the last usable Cloud context; opens New Cloud Machine when none is available
⌘ ⇧ Y	New Cloud machine
⌘ 1–8	Jump to workspace 1–8
⌘ 9	Jump to last workspace
⌃ ⌘ ]	Next workspace
⌃ ⌘ [	Previous workspace
⌘ ⇧ W	Close workspace
⌘ ⇧ R	Rename workspace
⌥ ⌘ E	Edit workspace description
⌘ B	Toggle sidebar
⌥ ⌘ B	Toggle right sidebar
⌘ ⇧ E	Toggle right sidebar focus

Shortcut	Action
⌘ T	New surface
⌘ ⇧ ]	Next surface
⌘ ⇧ [	Previous surface
⌃ Tab	Next surface
⌃ ⇧ Tab	Previous surface
⌃ 1–8	Jump to surface 1–8
⌃ 9	Jump to last surface
⌘ W	Close surface

Shortcut	Action
⌘ D	Split right
⌘ ⇧ D	Split down
⌥ ⌘ ← → ↑ ↓	Focus pane directionally
⌃ ⇧ H J K L	Resize pane left/down/up/right
⌘ ⇧ H	Flash focused panel

Shortcut	Action
⌘ ⇧ L	Open browser in split
⌘ L	Focus address bar
⌘ [	Back
⌘ ]	Forward
⌘ R	Reload page
⌥ ⌘ I	Toggle Developer Tools (Safari default)
⌥ ⌘ C	Show JavaScript Console (Safari default)

Shortcut	Action
⌘ I	Show notifications panel
⌘ ⇧ U	Jump to latest unread
⌥ ⌘ U	Toggle current item unread state
⌃ ⌘ U	Mark current item as oldest unread and jump to next latest unread
—	Mark all notifications read (unbound by default; configure in Settings or `cmux.json`)
—	Clear all notifications (unbound by default; configure in Settings or `cmux.json`)

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

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

Shortcut	Action
⌘ ⇧ N	New window
⌘ ⇧ O	Reopen previous session
⌘ ,	Settings
⌘ ⇧ ,	Reload configuration
⌘ Q	Quit

cmux

Features

Notification rings

Notification panel

In-app browser

Vertical + horizontal tabs

SSH

Claude Code Teams

Install

DMG (recommended)

Homebrew

Shell completion

Why cmux?

The Zen of cmux

Documentation

Keyboard Shortcuts

Workspaces

Surfaces

Split Panes

Browser

Notifications

Find

Terminal

Window

Nightly Builds

Session restore

FAQ

How does cmux relate to Ghostty?

What platforms does it support?

Is there an iOS app?

What coding agents does cmux work with?

Can cmux orchestrate multiple agents and subagents?

Can I use cmux with remote machines?

How do notifications work?

Is cmux programmable?

What can the built-in browser do?

Does cmux have skills?

Can I customize keyboard shortcuts?

Can I customize cmux?

Are my sessions saved?

How does it compare to tmux?

Is cmux free?

How can I support cmux?

I have a feature request or found a bug?

Star History

Contributing

Community

Founder's Edition

Install

DMG (recommended)

Homebrew

License