manaflow-ai /cmux
Open source Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents. Built for multitasking, organization, and programmability.
★ 28,791⑂ 2,668👁 41⑃ 34,110● 9,577▤ 396
+1
Daily
+118
Weekly
+663
Monthly
28,791
stars
2,668
forks
41
watchers
34,110
prs
9,577
issues
396
releases
README
cmux
A Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents
English | 日本語 | Tiếng Việt | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | ភាសាខ្មែរ | Українська
▶ Demo video · The Zen of cmux
Docs · Blog · Changelog · Community
Features
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.
- Browser import — Import cookies, history, and sessions from Chrome, Firefox, Arc, and 20+ browsers so browser panes start authenticated
- Custom commands — Define project-specific actions in cmux.json that launch from the command palette
- Programmable — CLI and socket API to create workspaces, split panes, send keystrokes, and automate the browser
- Native macOS app — Built with Swift and AppKit, not Electron. Fast startup, low memory.
- Ghostty compatible — Reads your existing ~/.config/ghostty/config for themes, fonts, and colors
- GPU-accelerated — Powered by libghostty for smooth rendering
- Keyboard shortcuts — Extensive shortcuts for workspaces, splits, browser, and more
- Open source — Free and GPL-licensed
Install
DMG (recommended)
Open the .dmg and drag cmux to your Applications folder. cmux auto-updates via Sparkle, so you only need to download once.
Homebrew
bash
brew tap manaflow-ai/cmux
brew install --cask cmux
To update later:
bash
brew upgrade --cask cmux
On first launch, macOS may ask you to confirm opening an app from an identified developer. Click Open to proceed.
Shell completion
The Homebrew cask installs completions for zsh, bash, and fish. Start a new shell after installing. If they don't load, make sure Homebrew's completion directories are wired into your shell (see Homebrew's shell completion docs).
If you installed cmux another way, add the matching line to your shell startup file, then start a new shell:
zsh
autoload -Uz compinit && compinit
eval "$(cmux completion zsh)"
bash
eval "$(cmux completion Top issues
#13742Design and product calls (gallery: #15427), plus CI admin324 comments · 2026-09-22#37411Cloud VM image roll is red212 comments · 2026-11-07#20668cmux NIGHTLY-identity publication failed (nightly.yml publish-nightly-identity-legacy)157 comments · 2026-10-14#25898GITHUB_TOKEN hourly budget is running low123 comments · 2026-10-27#21127Main full-suite CI is red93 comments · 2026-10-16#330Linux support?61 comments · 2026-02-23#13095[RFC] CI structure: thin router, reusable platform workflows, merge queue, failure ratchet57 comments · 2026-09-20#22648nightly-next canary failed44 comments · 2026-10-20
Discussions
#42367Mons: iPhone and iPad SSH access to persistent agent terminals (public beta)0 comments · 2026-11-13#41843bulkhead: keeping agents in neighboring cmux panes out of each other's way0 comments · 2026-11-12#35497Proposal: a source-preserving Markdown editor (math, in-place tables) for the Markdown viewer2 comments · 2026-11-04#35366cmux-sidebar: nested workspace groups and live agent dots, as a custom sidebar0 comments · 2026-11-04#30962cmux-dataview. Double-click a CSV in the file tree, get a real table0 comments · 2026-11-01#25922Recipe idea: cmux notify when a Taskhold task is blocked1 comments · 2026-10-27#24400Making a port for cmux to windows0 comments · 2026-10-22#23593Thread Desk: a local board for all your Claude Code tabs in cmux0 comments · 2026-10-21
Latest release
v0.65.2.2 v0.65.2.2 2026-10-27Full Changelog: https://github.com/manaflow-ai/cmux/compare/v0.65.2.1...v0.65.2.2