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
SwiftNOASSERTIONCreated 2026-01-28cmux.com
Download: v0.65.2.2v0.65.2.2 ↓0.65.2.22026-10-27
+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

Discussions

Latest release

v0.65.2.2 v0.65.2.2 2026-10-27
Full Changelog: https://github.com/manaflow-ai/cmux/compare/v0.65.2.1...v0.65.2.2

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON