cmux — What is it?

cmux is a native macOS terminal with vertical tabs and notifications, designed to enhance productivity for developers using AI coding agents.

⭐ 24,203 Stars 🍴 1,944 Forks Swift NOASSERTION Author: manaflow-ai
Source: Official README and linked documentation View on GitHub →

Why it matters

cmux is being discussed because its unique combination of terminal functionality with AI coding agent integration, addressing the pain points of managing multiple coding sessions and notifications. Its native macOS app and Swift/AppKit build differs, offering performance and integration advantages over Electron-based alternatives.

Source: Official README and linked documentation

Core Features

Notification rings

Panes and tabs are highlighted with blue rings and lights, respectively, when AI coding agents require attention, enhancing visibility and efficiency.

Source: Official README and linked documentation
Notification panel

A dedicated panel displays all pending notifications, allowing users to quickly access and respond to them, improving workflow management.

Source: Official README and linked documentation
In-app browser

An integrated browser allows for side-by-side terminal and browser usage, with a scriptable API for automation and interaction with development servers.

Source: Official README and linked documentation
Vertical + horizontal tabs

cmux supports both vertical and horizontal tab organization, with detailed sidebar information on each workspace, including git branch, PR status, and more.

Source: Official README and linked documentation
SSH

SSH functionality allows for remote workspace creation, with browser panes routing through the remote network for direct integration.

Source: Official README and linked documentation
Claude Code Teams

cmux supports Claude Code's teammate mode directly, with native splits and sidebar metadata, eliminating the need for additional tools like tmux.

Source: Official README and linked documentation
Browser import

cmux can import cookies, history, and sessions from various browsers, ensuring that browser panes start in an authenticated state.

Source: Official README and linked documentation
Custom commands

Users can define project-specific actions in `cmux.json`, accessible via the command palette, enhancing customization and workflow efficiency.

Source: Official README and linked documentation
Scriptable

cmux offers a CLI and socket API for automation, including workspace creation, pane splitting, keystroke sending, and browser operations.

Source: Official README and linked documentation
Native macOS app

Built with Swift and AppKit, cmux provides fast startup and low memory usage, offering a native macOS experience over Electron-based alternatives.

Source: Official README and linked documentation
Ghostty compatible

cmux reads existing Ghostty configurations for themes, fonts, and colors, ensuring a direct transition for users familiar with Ghostty.

Source: Official README and linked documentation
GPU-accelerated

cmux use libghostty for terminal rendering, providing smooth and efficient rendering with GPU acceleration.

Source: Official README and linked documentation

Architecture

The architecture of cmux is inferred to be modular, with a clear separation of concerns. It likely employs design patterns such as Model-View-Controller (MVC) for the user interface and separation of the terminal and browser functionalities. Data flow is managed through a well-defined API, and key technical decisions include the use of Swift and AppKit for the native macOS experience and integration with libghostty for terminal rendering.

Source: Official repository tree and dependency files

Project Knowledge Graph

Knowledge graph: project (center) + core features (inner hexagons) + key dependencies (outer chips) @opentui/core vercel Notification rings Notification panel In-app browser Vertical + horizontal tabsVertical + horizont… SSH Claude Code Teams Browser import Custom commands cmux Project Core feature Key dependency

Tech Stack

LanguageJavaScriptFrameworkSwift, AppKit
@opentui/corevercel
Not enough information.
Source: Official repository tree and dependency files

Quick Start

Download cmux for macOS from the GitHub releases page. Open the `.dmg` file, drag cmux to your Applications folder. cmux auto-updates via Sparkle. To install via Homebrew, run `brew tap manaflow-ai/cmux` followed by `brew install --cask cmux`. To update, use `brew upgrade --cask cmux`.
Source: Official README and linked documentation

Use Cases

cmux is suitable for developers who use macOS and require a terminal with advanced features for managing AI coding agents. It is particularly useful for those working with Claude Code, OpenCode, or similar tools, needing to manage multiple coding sessions and notifications efficiently.

Source: Official README and linked documentation

Strengths & Limitations

Strengths

  • cmux offers a unique combination of terminal functionality and AI coding agent integration, enhancing productivity for developers.
  • The native macOS app provides a fast and efficient user experience, superior to Electron-based alternatives.
  • cmux's scriptable nature allows for extensive customization and automation of workflows.

Limitations

  • The project's licensing information is not explicitly stated, which may be a concern for some users.
  • The project's documentation could be more broad, particularly for users unfamiliar with the underlying technologies.
Source: Official README and linked documentation

Latest Release

v0.64.10 (2026-05-23): Added features and fixes, including workspace reordering and codex goal control prototype. v0.64.9 (2026-05-22): Added codex goal control prototype and reverted previous changes. v0.64.8 (2026-05-22): Fixed option dead-key accent composition and migrated macOS CI to Warp. v0.64.7 (2026-05-19): Preserved unread indicators across session restore and fixed Slack connection issues.

Source: Official releases

Verdict

cmux is a project for developers looking to enhance their macOS terminal experience with advanced features for managing AI coding agents. Its native macOS app and integration with libghostty make it a choice for those seeking a fast, efficient, and customizable terminal environment.

Source: Official repository
Sources and review scope
This review is based on the project's public documentation. Versions, installation commands, and feature boundaries can change upstream; check the cited sources and current release before use. Sources checked on: 2026-09-23 10:52.

Reference materials: README, GitHub API, dependency files