manaflow-ai / cmux

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
 [code] 
To update later:
 [code] 
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:
 [code] 
 [code] 
 [code] 
## Why cmux?
I run a lot of Claude Code and Codex sessions in parallel. I was using Ghostty with a bunch of split panes, and relying on native macOS notifications to know when