cmux A Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe Features Notification rings Panes get a blue ring and tabs light up when AI 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, working directory, listening ports, and latest notification text. Split horizontally and vertically. Scriptable — 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 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 brew tap manaflow-ai/cmux brew install --cask cmux To update later: brew upgrade --cask cmux On first launch, macOS may ask you to confirm opening an app from an identified developer. Click Open to proceed. 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 an agent needed me. But Claude Code’s notification body is always just “Claude is waiting for your input” with no context, and with enough tabs open I couldn’t even read the titles anymore. I tried a few coding orchestrators but most of them were Electron/Tauri apps and the performance bugged me. I also just prefer the terminal since GUI orchestrators lock you into their workflow. So I built cmux as a native macOS app in Swift/AppKit. It uses libghostty for terminal rendering and reads your existing Ghostty config for themes, fonts, and colors. The main additions are the sidebar and notification system. The sidebar has vertical tabs that show git branch, working directory, listening ports, and the latest notification text for each workspace. The notification system picks up terminal sequences (OSC 9/99/777) and has a CLI (cmux notify) you can wire into agent hooks for Claude Code, OpenCode, etc. When an agent is waiting, its pane gets a blue ring and the tab lights up in the sidebar, so I can tell which one needs me across splits and tabs. Cmd+Shift+U jumps to the most recent unread. The in-app browser has a scriptable API ported from agent-browser. Agents can snapshot the accessibility tree, get element refs, click, fill forms, and evaluate JS. You can split a browser pane next to your terminal and have Claude Code interact with your dev server directly. Everything is scriptable through the CLI and socket API — create workspaces/tabs, split panes, send keystrokes, open URLs in the browser. Keyboard Shortcuts Workspaces Shortcut Action ⌘ N New workspace ⌘ 1–8 Jump to workspace 1–8 ⌘ 9 Jump to last workspace ⌃ ⌘ ] Next workspace ⌃ ⌘ [ Previous workspace ⌘ ⇧ W Close workspace ⌘ B Toggle sidebar Surfaces 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 Split Panes Shortcut Action ⌘ D Split right ⌘ ⇧ D Split down ⌥ ⌘ ← → ↑ ↓ Focus pane directionally ⌘ ⇧ H Flash focused panel Browser Shortcut Action ⌘ ⇧ L Open browser in split ⌘ L Focus address bar ⌘ [ Back ⌘ ] Forward ⌘ R Reload page ⌥ ⌘ I Open Developer Tools Notifications Shortcut Action ⌘ I Show notifications panel ⌘ ⇧ U Jump to latest unread Find Shortcut Action ⌘ F Find ⌘ G / ⌘ ⇧ G Find next / previous ⌘ ⇧ F Hide find bar ⌘ E Use selection for find Terminal Shortcut Action ⌘ K Clear scrollback ⌘ C Copy (with selection) ⌘ V Paste ⌘ + / ⌘ – Increase / decrease font size ⌘ 0 Reset font size Window Shortcut Action ⌘ ⇧ N New window ⌘ , Settings ⌘ ⇧ , Reload configuration ⌘ Q Quit License This project is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later). See LICENSE for the full text. Related posts: Railway secures $100 million to challenge AWS with AI-native cloud inf Railway secures funding to accelerate AI ambitions OpenClaw announces developments in AI space Railway lands investment to scale operations Post navigation Show HN: Micasa – track your house from the terminal A psychedelic medicine performs well against depression
cmux A Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents English | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe Features Notification rings Panes get a blue ring and tabs light up when AI 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, working directory, listening ports, and latest notification text. Split horizontally and vertically. Scriptable — 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 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 brew tap manaflow-ai/cmux brew install --cask cmux To update later: brew upgrade --cask cmux On first launch, macOS may ask you to confirm opening an app from an identified developer. Click Open to proceed. 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 an agent needed me. But Claude Code’s notification body is always just “Claude is waiting for your input” with no context, and with enough tabs open I couldn’t even read the titles anymore. I tried a few coding orchestrators but most of them were Electron/Tauri apps and the performance bugged me. I also just prefer the terminal since GUI orchestrators lock you into their workflow. So I built cmux as a native macOS app in Swift/AppKit. It uses libghostty for terminal rendering and reads your existing Ghostty config for themes, fonts, and colors. The main additions are the sidebar and notification system. The sidebar has vertical tabs that show git branch, working directory, listening ports, and the latest notification text for each workspace. The notification system picks up terminal sequences (OSC 9/99/777) and has a CLI (cmux notify) you can wire into agent hooks for Claude Code, OpenCode, etc. When an agent is waiting, its pane gets a blue ring and the tab lights up in the sidebar, so I can tell which one needs me across splits and tabs. Cmd+Shift+U jumps to the most recent unread. The in-app browser has a scriptable API ported from agent-browser. Agents can snapshot the accessibility tree, get element refs, click, fill forms, and evaluate JS. You can split a browser pane next to your terminal and have Claude Code interact with your dev server directly. Everything is scriptable through the CLI and socket API — create workspaces/tabs, split panes, send keystrokes, open URLs in the browser. Keyboard Shortcuts Workspaces Shortcut Action ⌘ N New workspace ⌘ 1–8 Jump to workspace 1–8 ⌘ 9 Jump to last workspace ⌃ ⌘ ] Next workspace ⌃ ⌘ [ Previous workspace ⌘ ⇧ W Close workspace ⌘ B Toggle sidebar Surfaces 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 Split Panes Shortcut Action ⌘ D Split right ⌘ ⇧ D Split down ⌥ ⌘ ← → ↑ ↓ Focus pane directionally ⌘ ⇧ H Flash focused panel Browser Shortcut Action ⌘ ⇧ L Open browser in split ⌘ L Focus address bar ⌘ [ Back ⌘ ] Forward ⌘ R Reload page ⌥ ⌘ I Open Developer Tools Notifications Shortcut Action ⌘ I Show notifications panel ⌘ ⇧ U Jump to latest unread Find Shortcut Action ⌘ F Find ⌘ G / ⌘ ⇧ G Find next / previous ⌘ ⇧ F Hide find bar ⌘ E Use selection for find Terminal Shortcut Action ⌘ K Clear scrollback ⌘ C Copy (with selection) ⌘ V Paste ⌘ + / ⌘ – Increase / decrease font size ⌘ 0 Reset font size Window Shortcut Action ⌘ ⇧ N New window ⌘ , Settings ⌘ ⇧ , Reload configuration ⌘ Q Quit License This project is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later). See LICENSE for the full text.
