manaflow-ai/cmux

<h1 align="center"cmux</h1 <p align="center"A Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents</p

<p align="center" <a href="https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg" <img src="./docs/assets/macos-badge.png" alt="Download cmux for macOS" width="180" / </a </p

<p align="center" English | <a href="README.ja.md"日本語</a | <a href="README.vi.md"Tiếng Việt</a | <a href="README.zh-CN.md"简体中文</a | <a href="README.zh-TW.md"繁體中文</a | <a href="README.ko.md"한국어</a | <a href="README.de.md"Deutsch</a | <a href="README.es.md"Español</a | <a href="README.fr.md"Français</a | <a href="README.it.md"Italiano</a | <a href="README.da.md"Dansk</a | <a href="README.pl.md"Polski</a | <a href="README.ru.md"Русский</a | <a href="README.bs.md"Bosanski</a | <a href="README.ar.md"العربية</a | <a href="README.no.md"Norsk</a | <a href="README.pt-BR.md"Português (Brasil)</a | <a href="README.th.md"ไทย</a | <a href="README.tr.md"Türkçe</a | <a href="README.km.md"ភាសាខ្មែរ</a | <a href="README.uk.md"Українська</a </p

<p align="center" <a href="https://x.com/manaflowai"<img src="https://img.shields.io/badge/@manaflow-555?logo=x" alt="X / Twitter" /</a <a href="https://discord.gg/xsgFEVrWCZ"<img src="https://img.shields.io/badge/Discord-555?logo=discord" alt="Discord" /</a <a href="https://github.com/manaflow-ai/cmux"<img src="https://img.shields.io/github/stars/manaflow-ai/cmux?style=flat&logo=github&label=stars&color=4c71f2" alt="GitHub stars" /</a </p

<p align="center" <img src="./docs/assets/main-first-image.png" alt="cmux screenshot" width="900" / </p

<p align="center" <a href="https://www.youtube.com/watch?v=i-WxO5YUTOs"▶ Demo video</a · <a href="https://cmux.com/blog/zen-of-cmux"The Zen of cmux</a </p

Features

<table <tr <td width="40%" valign="middle" <h3Notification rings</h3 Panes get a blue ring and tabs light up when coding agents need your attention </td <td width="60%" <img src="./docs/assets/notification-rings.png" alt="Notification rings" width="100%" / </td </tr <tr <td width="40%" valign="middle" <h3Notification panel</h3 See all pending notifications in one place, jump to the most recent unread </td <td width="60%" <img src="./docs/assets/sidebar-notification-badge.png" alt="Sidebar notification badge" width="100%" / </td </tr <tr <td width="40%" valign="middle" <h3In-app browser</h3 Split a browser alongside your terminal with a scriptable API ported from <a href="https://github.com/vercel-labs/agent-browser"agent-browser</a </td <td width="60%" <img src="./docs/assets/built-in-browser.png" alt="Built-in browser" width="100%" / </td </tr <tr <td width="40%" valign="middle" <h3Vertical + horizontal tabs</h3 Sidebar shows git branch, linked PR status/number, working directory, listening ports, and latest notification text. Split horizontally and vertically. </td <td width="60%" <img src="./docs/assets/vertical-horizontal-tabs-and-splits.png" alt="Vertical tabs and split panes" width="100%" / </td </tr <tr <td width="40%" valign="middle" <h3SSH</h3 <codecmux ssh user@remote</code creates a workspace for a remote machine. Pass <code--command 'omp "investigate auth"'</code 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. </td <td width="60%" <img src="./docs/assets/ssh.png" alt="cmux SSH" width="100%" / </td </tr <tr <td width="40%" valign="middle" <h3Claude Code Teams</h3 <codecmux claude-teams</code runs Claude Code's teammate mode with one command. Teammates spawn as native splits with sidebar metadata and notifications. No tmux required. </td <td width="60%" <img src="./docs/assets/claude-code-teams.png" alt="Claude Code Teams" width="100%" / </td </tr </table

• 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)

<a href="https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg" <img src="./docs/assets/macos-badge.png" alt="Download cmux for macOS" width="180" / </a

Open the .dmg and drag cmux to your Applications folder. cmux auto-updates via Sparkle, so you only need to download once.

Homebrew

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

To update later:

brew upgrade --cask cmux