manaflow-ai/cmuxPublic

Open source Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents. Built for multitasking, organization, and programmability.

AI summary: A terminal multiplexer optimized for coordinating multiple AI coding agents with integrated scriptable browsing.

Stars
28.8K
+41 today
Forks
2.7K
Watchers
42
Open issues
4.3K
Open PRs
2.7K
Contributors
~262
Commits
21.3K
Branches
31.1K
Views (30d)
4

SwiftOtherCreated Jan 28, 2026Last push 1d agoLatest release v0.65.2.2+62 stars this week+537 this month

Quick answers

What is cmux?
A terminal multiplexer optimized for coordinating multiple AI coding agents with integrated scriptable browsing.
What does cmux do?
Cmux is an advanced terminal multiplexer specifically engineered to manage the complexity of running multiple autonomous AI coding agents simultaneously. It features a comprehensive notification system, utilizing visual rings and a dedicated sidebar to alert users when specific agent panes require attention. Beyond standard split panes and horizontal/vertical tabs, it uniquely incorporates a scriptable, built-in browser API ported directly from agent-browser. This highly integrated environment allows developers to monitor agent execution, review PR statuses, and browse web context seamlessly within a single workspace.
Who is cmux for?
Developers and engineers who heavily utilize multi-agent systems and require a specialized terminal environment to orchestrate them efficiently. The platform simplifies complex workflows and accelerates development timelines.
How do I get started with cmux?
Download the macOS dmg from releases.
How popular is cmux on GitHub?
manaflow-ai/cmux has 28,832 stars and 2,684 forks on GitHub, and gained 62 stars in the last 7 days.
What license does cmux use?
manaflow-ai/cmux is released under the Other license.

Star history

since Jul 30, 2026
010K20KJul 2026Sep 2026Oct 2026Nov 2026
28.8K stars as of Nov 19, 2026. Measured daily since Jul 30, 2026; GitHub no longer exposes earlier star timestamps.

Update history

3 recorded
  • Nov 4, 2026New release v0.65.2.2 (previously v0.65.2).
  • Oct 17, 2026New release v0.65.2 (previously v0.65.0).
  • Oct 7, 2026New release v0.65.0 (previously v0.64.25).

Contribution activity

commits per day, last 52 weeks
NovDecJanFebMarAprMayJunJulAugSepOctNovMonWedFri2025-11-23: 0 commits2025-11-24: 0 commits2025-11-25: 0 commits2025-11-26: 0 commits2025-11-27: 0 commits2025-11-28: 0 commits2025-11-29: 0 commits2025-11-30: 0 commits2025-12-01: 0 commits2025-12-02: 0 commits2025-12-03: 0 commits2025-12-04: 0 commits2025-12-05: 0 commits2025-12-06: 0 commits2025-12-07: 0 commits2025-12-08: 0 commits2025-12-09: 0 commits2025-12-10: 0 commits2025-12-11: 0 commits2025-12-12: 0 commits2025-12-13: 0 commits2025-12-14: 0 commits2025-12-15: 0 commits2025-12-16: 0 commits2025-12-17: 0 commits2025-12-18: 0 commits2025-12-19: 0 commits2025-12-20: 0 commits2025-12-21: 0 commits2025-12-22: 0 commits2025-12-23: 0 commits2025-12-24: 0 commits2025-12-25: 0 commits2025-12-26: 0 commits2025-12-27: 0 commits2025-12-28: 0 commits2025-12-29: 0 commits2025-12-30: 0 commits2025-12-31: 0 commits2026-01-01: 0 commits2026-01-02: 0 commits2026-01-03: 0 commits2026-01-04: 0 commits2026-01-05: 0 commits2026-01-06: 0 commits2026-01-07: 0 commits2026-01-08: 0 commits2026-01-09: 0 commits2026-01-10: 0 commits2026-01-11: 0 commits2026-01-12: 0 commits2026-01-13: 0 commits2026-01-14: 0 commits2026-01-15: 0 commits2026-01-16: 0 commits2026-01-17: 0 commits2026-01-18: 0 commits2026-01-19: 0 commits2026-01-20: 0 commits2026-01-21: 0 commits2026-01-22: 16 commits2026-01-23: 9 commits2026-01-24: 0 commits2026-01-25: 6 commits2026-01-26: 10 commits2026-01-27: 0 commits2026-01-28: 32 commits2026-01-29: 34 commits2026-01-30: 6 commits2026-01-31: 0 commits2026-02-01: 1 commit2026-02-02: 0 commits2026-02-03: 4 commits2026-02-04: 2 commits2026-02-05: 9 commits2026-02-06: 4 commits2026-02-07: 0 commits2026-02-08: 18 commits2026-02-09: 20 commits2026-02-10: 28 commits2026-02-11: 4 commits2026-02-12: 0 commits2026-02-13: 1 commit2026-02-14: 23 commits2026-02-15: 20 commits2026-02-16: 11 commits2026-02-17: 37 commits2026-02-18: 54 commits2026-02-19: 44 commits2026-02-20: 141 commits2026-02-21: 51 commits2026-02-22: 65 commits2026-02-23: 128 commits2026-02-24: 80 commits2026-02-25: 75 commits2026-02-26: 30 commits2026-02-27: 28 commits2026-02-28: 22 commits2026-03-01: 22 commits2026-03-02: 20 commits2026-03-03: 15 commits2026-03-04: 34 commits2026-03-05: 85 commits2026-03-06: 38 commits2026-03-07: 22 commits2026-03-08: 14 commits2026-03-09: 38 commits2026-03-10: 46 commits2026-03-11: 57 commits2026-03-12: 42 commits2026-03-13: 115 commits2026-03-14: 4 commits2026-03-15: 29 commits2026-03-16: 30 commits2026-03-17: 65 commits2026-03-18: 47 commits2026-03-19: 18 commits2026-03-20: 45 commits2026-03-21: 16 commits2026-03-22: 29 commits2026-03-23: 46 commits2026-03-24: 19 commits2026-03-25: 52 commits2026-03-26: 27 commits2026-03-27: 14 commits2026-03-28: 15 commits2026-03-29: 6 commits2026-03-30: 61 commits2026-03-31: 22 commits2026-04-01: 51 commits2026-04-02: 17 commits2026-04-03: 39 commits2026-04-04: 3 commits2026-04-05: 29 commits2026-04-06: 39 commits2026-04-07: 37 commits2026-04-08: 19 commits2026-04-09: 19 commits2026-04-10: 33 commits2026-04-11: 6 commits2026-04-12: 11 commits2026-04-13: 10 commits2026-04-14: 21 commits2026-04-15: 18 commits2026-04-16: 1 commit2026-04-17: 18 commits2026-04-18: 10 commits2026-04-19: 9 commits2026-04-20: 9 commits2026-04-21: 12 commits2026-04-22: 6 commits2026-04-23: 2 commits2026-04-24: 4 commits2026-04-25: 17 commits2026-04-26: 11 commits2026-04-27: 9 commits2026-04-28: 68 commits2026-04-29: 68 commits2026-04-30: 48 commits2026-05-01: 75 commits2026-05-02: 8 commits2026-05-03: 25 commits2026-05-04: 59 commits2026-05-05: 27 commits2026-05-06: 22 commits2026-05-07: 10 commits2026-05-08: 33 commits2026-05-09: 10 commits2026-05-10: 11 commits2026-05-11: 37 commits2026-05-12: 65 commits2026-05-13: 40 commits2026-05-14: 19 commits2026-05-15: 51 commits2026-05-16: 11 commits2026-05-17: 81 commits2026-05-18: 115 commits2026-05-19: 128 commits2026-05-20: 77 commits2026-05-21: 40 commits2026-05-22: 66 commits2026-05-23: 39 commits2026-05-24: 5 commits2026-05-25: 19 commits2026-05-26: 100 commits2026-05-27: 166 commits2026-05-28: 86 commits2026-05-29: 64 commits2026-05-30: 60 commits2026-05-31: 92 commits2026-06-01: 135 commits2026-06-02: 195 commits2026-06-03: 234 commits2026-06-04: 252 commits2026-06-05: 94 commits2026-06-06: 40 commits2026-06-07: 38 commits2026-06-08: 37 commits2026-06-09: 117 commits2026-06-10: 110 commits2026-06-11: 64 commits2026-06-12: 135 commits2026-06-13: 114 commits2026-06-14: 69 commits2026-06-15: 58 commits2026-06-16: 41 commits2026-06-17: 43 commits2026-06-18: 44 commits2026-06-19: 39 commits2026-06-20: 32 commits2026-06-21: 39 commits2026-06-22: 73 commits2026-06-23: 59 commits2026-06-24: 16 commits2026-06-25: 30 commits2026-06-26: 16 commits2026-06-27: 7 commits2026-06-28: 8 commits2026-06-29: 86 commits2026-06-30: 17 commits2026-07-01: 64 commits2026-07-02: 48 commits2026-07-03: 104 commits2026-07-04: 154 commits2026-07-05: 192 commits2026-07-06: 182 commits2026-07-07: 186 commits2026-07-08: 73 commits2026-07-09: 102 commits2026-07-10: 25 commits2026-07-11: 21 commits2026-07-12: 27 commits2026-07-13: 55 commits2026-07-14: 72 commits2026-07-15: 76 commits2026-07-16: 44 commits2026-07-17: 43 commits2026-07-18: 11 commits2026-07-19: 31 commits2026-07-20: 15 commits2026-07-21: 51 commits2026-07-22: 94 commits2026-07-23: 200 commits2026-07-24: 171 commits2026-07-25: 141 commits2026-07-26: 62 commits2026-07-27: 68 commits2026-07-28: 107 commits2026-07-29: 80 commits2026-07-30: 77 commits2026-07-31: 116 commits2026-08-01: 49 commits2026-08-02: 33 commits2026-08-03: 127 commits2026-08-04: 246 commits2026-08-05: 159 commits2026-08-06: 202 commits2026-08-07: 250 commits2026-08-08: 74 commits2026-08-09: 274 commits2026-08-10: 172 commits2026-08-11: 105 commits2026-08-12: 106 commits2026-08-13: 218 commits2026-08-14: 121 commits2026-08-15: 13 commits2026-08-16: 8 commits2026-08-17: 80 commits2026-08-18: 119 commits2026-08-19: 196 commits2026-08-20: 115 commits2026-08-21: 105 commits2026-08-22: 50 commits2026-08-23: 622 commits2026-08-24: 187 commits2026-08-25: 169 commits2026-08-26: 58 commits2026-08-27: 104 commits2026-08-28: 102 commits2026-08-29: 16 commits2026-08-30: 34 commits2026-08-31: 60 commits2026-09-01: 78 commits2026-09-02: 339 commits2026-09-03: 52 commits2026-09-04: 117 commits2026-09-05: 10 commits2026-09-06: 46 commits2026-09-07: 28 commits2026-09-08: 103 commits2026-09-09: 75 commits2026-09-10: 152 commits2026-09-11: 131 commits2026-09-12: 300 commits2026-09-13: 476 commits2026-09-14: 131 commits2026-09-15: 192 commits2026-09-16: 245 commits2026-09-17: 119 commits2026-09-18: 48 commits2026-09-19: 208 commits2026-09-20: 694 commits2026-09-21: 431 commits2026-09-22: 382 commits2026-09-23: 452 commits2026-09-24: 581 commits2026-09-25: 407 commits2026-09-26: 256 commits2026-09-27: 479 commits2026-09-28: 171 commits2026-09-29: 81 commits2026-09-30: 177 commits2026-10-01: 269 commits2026-10-02: 185 commits2026-10-03: 70 commits2026-10-04: 82 commits2026-10-05: 188 commits2026-10-06: 119 commits2026-10-07: 72 commits2026-10-08: 96 commits2026-10-09: 104 commits2026-10-10: 90 commits2026-10-11: 150 commits2026-10-12: 119 commits2026-10-13: 44 commits2026-10-14: 94 commits2026-10-15: 24 commits2026-10-16: 20 commits2026-10-17: 60 commits2026-10-18: 201 commits2026-10-19: 90 commits2026-10-20: 65 commits2026-10-21: 92 commits2026-10-22: 2 commits2026-10-23: 18 commits2026-10-24: 20 commits2026-10-25: 19 commits2026-10-26: 129 commits2026-10-27: 141 commits2026-10-28: 58 commits2026-10-29: 69 commits2026-10-30: 77 commits2026-10-31: 66 commits2026-11-01: 17 commits2026-11-02: 24 commits2026-11-03: 41 commits2026-11-04: 68 commits2026-11-05: 36 commits2026-11-06: 12 commits2026-11-07: 13 commits2026-11-08: 54 commits2026-11-09: 45 commits2026-11-10: 58 commits2026-11-11: 12 commits2026-11-12: 15 commits2026-11-13: 8 commits2026-11-14: 28 commits2026-11-15: 22 commits2026-11-16: 0 commits2026-11-17: 0 commits2026-11-18: 0 commits2026-11-19: 0 commits2026-11-20: 0 commits2026-11-21: 0 commits
23,746 commits in the last yearLessMore

Signals and awards

derived from tracked data
  • Widely adopted

    28,832 stars

  • Very active

    23,746 commits in 52 weeks

  • Community-driven

    ~262 contributors

  • Well documented

    High community health score

  • Repeat trending

    6 trending appearances

What cmux does

Cmux is an advanced terminal multiplexer specifically engineered to manage the complexity of running multiple autonomous AI coding agents simultaneously. It features a comprehensive notification system, utilizing visual rings and a dedicated sidebar to alert users when specific agent panes require attention. Beyond standard split panes and horizontal/vertical tabs, it uniquely incorporates a scriptable, built-in browser API ported directly from agent-browser. This highly integrated environment allows developers to monitor agent execution, review PR statuses, and browse web context seamlessly within a single workspace.

Developers and engineers who heavily utilize multi-agent systems and require a specialized terminal environment to orchestrate them efficiently. The platform simplifies complex workflows and accelerates development timelines.

  • Visual notification rings: Highlights specific terminal panes with blue rings to visually indicate when an AI agent needs attention.
  • Centralized notification panel: Aggregates all pending agent alerts in a dedicated sidebar for incredibly quick review and navigation.
  • Integrated scriptable browser: Embeds a web browser alongside the terminal to provide agents with immediate contextual access.
  • Advanced workspace multiplexing: Supports complex layouts with horizontal and vertical tabs strictly tailored for multi-agent execution.
  • Context-aware sidebar: Displays active git branches, PR status, working directories, and listening ports clearly at a glance.

Where teams use it

Multi-agent Orchestration

Monitor and manage several autonomous coding agents simultaneously without losing track of their individual execution progress.

Contextual AI Development

Provide active agents with immediate access to a built-in browser for referencing critical documentation while coding.

Streamlined Workspace Management

Organize complex terminal layouts that explicitly display crucial git and networking context alongside active processes.

Efficient Alert Handling

Quickly identify and respond to specific agent prompts using the centralized notification panel and distinct visual indicators.

Getting started: Download the macOS dmg from releases.

README

main branch

cmux

A Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents

Download cmux for macOS

English | 日本語 | Tiếng Việt | 简体中文 | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | Polski | Русский | Bosanski | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | ភាសាខ្មែរ | Українська

X / Twitter Discord GitHub stars

cmux screenshot

▶ 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 rings

Notification panel

See all pending notifications in one place, jump to the most recent unread
Sidebar notification badge

In-app browser

Split a browser alongside your terminal with a scriptable API ported from agent-browser
Built-in browser

Vertical + horizontal tabs

Sidebar shows git branch, linked PR status/number, working directory, listening ports, and latest notification text. Split horizontally and vertically.
Vertical tabs and split panes

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.
cmux SSH

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.
Claude Code Teams
  • 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)

Download cmux for macOS

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.

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:

autoload -Uz compinit && compinit
eval "$(cmux completion zsh)"
eval "$(cmux completion bash)"
cmux completion fish | source

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, linked PR status/number, 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.

The Zen of cmux

cmux is not prescriptive about how developers hold their tools. It's a terminal and browser with a CLI, and the rest is up to you.

cmux is a primitive, not a solution. It gives you a terminal, a browser, notifications, workspaces, splits, tabs, and a CLI to control all of it. cmux doesn't force you into an opinionated way to use coding agents. What you build with the primitives is yours.

The best developers have always built their own tools. Nobody has figured out the best way to work with agents yet, and the teams building closed products definitely haven't either. The developers closest to their own codebases will figure it out first.

Give a million developers composable primitives and they'll collectively find the most efficient workflows faster than any product team could design top-down.

Documentation

For more info on how to configure cmux, head over to our docs.

To theme cmux (colors, fonts, transparency, sidebar, and more), see Customizing cmux's look.

For shell watcher churn and managed-Mac process audit volume, see the supported CMUX_NO_GIT_WATCH=1 mitigation and its Git/PR update trade-offs.

Keyboard Shortcuts

Workspaces

Shortcut Action
⌘ N New local workspace
⌘ Y New Cloud workspace on the last usable Cloud context; opens New Cloud Machine when none is available
⌘ ⇧ Y New Cloud machine
⌘ 1–8 Jump to workspace 1–8
⌘ 9 Jump to last workspace
⌃ ⌘ ] Next workspace
⌃ ⌘ [ Previous workspace
⌘ ⇧ W Close workspace
⌘ ⇧ R Rename workspace
⌥ ⌘ E Edit workspace description
⌘ B Toggle sidebar
⌥ ⌘ B Toggle right sidebar
⌘ ⇧ E Toggle right sidebar focus

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 J K L Resize pane left/down/up/right
⌘ ⇧ H Flash focused panel

Browser

Browser developer-tool shortcuts follow Safari defaults and are customizable in Settings → Keyboard Shortcuts. Command palette navigation shortcuts, including ⌃ P, are also customizable and can be cleared so the keypress reaches the active terminal.

Shortcut Action
⌘ ⇧ L Open browser in split
⌘ L Focus address bar
⌘ [ Back
⌘ ] Forward
⌘ R Reload page
⌥ ⌘ I Toggle Developer Tools (Safari default)
⌥ ⌘ C Show JavaScript Console (Safari default)

Notifications

Shortcut Action
⌘ I Show notifications panel
⌘ ⇧ U Jump to latest unread
⌥ ⌘ U Toggle current item unread state
⌃ ⌘ U Mark current item as oldest unread and jump to next latest unread
— Mark all notifications read (unbound by default; configure in Settings or cmux.json)
— Clear all notifications (unbound by default; configure in Settings or cmux.json)

Find

Shortcut Action
⌘ F Find
⌘ ⇧ F Find in directory
⌘ 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
⌘ ⇧ O Reopen previous session
⌘ , Settings
⌘ ⇧ , Reload configuration
⌘ Q Quit

Nightly Builds

Download cmux NIGHTLY (universal; updates then switch to your Mac's architecture automatically)

cmux NIGHTLY is a separate app with its own bundle ID, so it runs alongside the stable version. Built automatically from the latest main commit and auto-updates via its own Sparkle feed.

Report nightly bugs on GitHub Issues or in #nightly-bugs on Discord.

Session restore

Quitting cmux saves the current session. On relaunch, cmux restores app-owned state:

  • Window/workspace/pane layout
  • Working directories
  • Terminal scrollback (best effort)
  • Browser URL and navigation history

cmux does not checkpoint arbitrary live process state. Ordinary terminals, tmux, vim, shells, and unsupported terminal apps reopen as normal terminals. For live detach/reattach across cmux quit, crashes, and updates, opt in to the local tmux owner with cmux local-tmux; see docs/local-tmux.md for its lifecycle and machine-sleep limits. zellij users can use cmux local-zellij instead; see docs/local-zellij.md.

Supported agent sessions can resume when hooks have saved a native session ID. Install hooks after installing the agent CLI so its binary is on PATH:

cmux hooks setup
cmux hooks setup codex
cmux hooks setup --agent opencode

cmux hooks setup installs supported agents it can find and prints a summary for skipped agents. Supported resume integrations include Claude Code, Codex, Grok, OpenCode, Pi, Amp, Cursor CLI, Gemini, Rovo Dev, Copilot, CodeBuddy, Factory, and Qoder. Claude Code is handled by the cmux Claude wrapper when Claude integration is enabled in Settings.

Advanced users and integrations can attach a custom resume command to the current terminal surface. This is useful for tools with their own durable state, such as tmux sessions or custom agent CLIs:

cmux surface resume set --kind tmux --checkpoint work --shell "tmux attach -t work"
cmux surface resume show --json
cmux surface resume clear --checkpoint work

The binding stays attached to the cmux surface. Public CLI or socket-created bindings are stored for inspection and manual restore unless you approve a signed command prefix for automatic restore. Approved prefixes are also bound to the working directory and exact environment values, when present. Review or edit approvals in Settings > Terminal > Resume Commands. cmux only auto-runs resume bindings it marks trusted, such as live process-detected tmux bindings or user-approved prefixes. Sensitive environment keys such as tokens, passwords, secrets, and API keys are dropped before a resume binding is stored.

To keep restored agent terminals idle instead of automatically running their resume commands, turn off Settings > Terminal > Resume Agent Sessions on Reopen or set this in ~/.config/cmux/cmux.json:

{
  "terminal": {
    "autoResumeAgentSessions": false
  }
}

This only disables automatic agent resume commands. cmux still restores the saved layout, working directories, scrollback, and browser history.

If you need to reapply the last saved snapshot manually, use:

  • File > Reopen Previous Session
  • ⌘ ⇧ O
  • cmux restore-session

Each cmux install (stable, nightly, rc, staging, and tagged debug builds) keeps its own saved session. To bring a session from one install into another, for example after trying nightly and switching back to stable, run this from the install you want to open it in:

cmux restore-session --from nightly          # or stable, rc, staging, debug:<tag>
cmux restore-session --export ~/session.json # write this install's saved session to a file
cmux restore-session --export ~/session.json --force # replace an existing export file
cmux restore-session --from ~/session.json   # reopen an exported file

The imported session opens as additional windows next to the ones you have, like cmux restore-session; the other install's saved file is only read. Agent resume carries over because hook session mappings in ~/.cmuxterm/ are shared by every install. Browser cookies and logins are per install and do not move.

--from <channel> restores another install's own session file with the same trust as your own session, including automatic agent resume. --from <path> treats the file as untrusted: layout, working directories, text scrollback, and http(s) browser tabs restore, but nothing in the file runs automatically. Built-in agents (Claude Code, Codex, Amp, and the rest) resume with the command cmux builds from the agent kind and session id, ignoring launch arguments stored in the file, and only when the working directory already exists on this Mac. Custom agent resume commands, resume bindings, and tmux start commands are kept for manual restore only (approved resume prefixes never apply to them): the CLI reports how many were held back, and in each terminal cmux surface resume show shows the command and cmux restore --surface runs it. Terminal control sequences in the scrollback (clipboard, notifications, links, titles), draft attachments, non-http(s) browser pages and profiles, SSH/cloud connections, and workspace environment variables from the file are dropped. A snapshot saved by a newer cmux (newer session format) is refused with an error; if a downgraded cmux finds one in its own session file, it keeps a copy next to it as session-<bundle id>.schema-v<N>.json.

Under the hood, cmux writes a versioned snapshot under ~/Library/Application Support/cmux/ and agent hooks write session mappings under ~/.cmuxterm/. On restore, cmux rebuilds the layout first, then runs the supported agent's native resume command when automatic agent resume is enabled.

Read the full guide at https://cmux.com/docs/session-restore.

FAQ

How does cmux relate to Ghostty?

cmux is not a fork of Ghostty. It uses libghostty as a library for terminal rendering, the same way apps use WebKit for web views. Ghostty is a standalone terminal; cmux is a different app built on top of its rendering engine.

What platforms does it support?

macOS only, for now. cmux is a native Swift + AppKit app.

Is there an iOS app?

Yes, in beta. Pair your iPhone with your Mac from the Mobile Connect window and attach to your terminals from your phone, with optional forwarding of terminal notifications. It ships on TestFlight as cmux BETA. Early access is included with cmux Pro. See the iOS docs.

What coding agents does cmux work with?

All of them. cmux is a terminal, so any agent that runs in a terminal works out of the box: Claude Code, Codex, OpenCode, Gemini CLI, Kiro, Aider, Goose, Amp, Cline, Cursor Agent, and anything else you can launch from the command line.

Can cmux orchestrate multiple agents and subagents?

Yes. When an agent spawns subagents or teammates, cmux turns them into native panes and splits instead of hidden background processes. It supports Claude Code teams and oh-my-opencode multi-model orchestration, so every agent in a run is visible and controllable.

Can I use cmux with remote machines?

Yes. Open workspaces over SSH and attach to remote tmux sessions, so agents can run on a remote host while you drive them from cmux. See SSH and remote.

How do notifications work?

When a process needs attention, cmux shows notification rings around panes, unread badges in the sidebar, a notification popover, and a macOS desktop notification. These fire automatically via standard terminal escape sequences (OSC 9/99/777), or you can trigger them with the cmux CLI and agent hooks. Any agent that supports hooks or OSC works, including Claude Code, Codex, OpenCode, and pi.

Is cmux programmable?

Yes. Every action is available through the cmux CLI and a Unix socket: create workspaces, open split panes, send input, read screen contents, take screenshots, and drive the in-app browser. See the CLI reference and browser automation docs.

What can the built-in browser do?

cmux can split a real browser pane next to your terminal, and it is fully programmable: navigate, snapshot the DOM, click, type, evaluate JavaScript, and read console and network activity over the same socket API. Agents use it to verify their own web changes without leaving cmux. See browser automation.

Does cmux have skills?

Yes. Skills are reusable workflows you can give any agent running in cmux, for things like CLI control, workspace automation, settings, and browser surfaces. Browse the open collection at cmux-skills, or read the skills docs.

Can I customize keyboard shortcuts?

Terminal keybindings are read from your Ghostty config file (~/.config/ghostty/config), including leader sequences and key tables. Ghostty tab actions target cmux workspaces; see the action mapping, precedence, and limitations. cmux-specific shortcuts (workspaces, splits, browser, notifications) can be customized in Settings. See the default shortcuts for a full list.

Can I customize cmux?

Yes. Terminal rendering uses your Ghostty config, so themes, fonts, colors, and cursor carry over directly. cmux's own settings in ~/.config/cmux/cmux.json control the sidebar, tab bar, split panes, and behavior, and every keyboard shortcut is editable. See configuration.

Are my sessions saved?

cmux restores windows, workspaces, panes, working directories, and best-effort scrollback when you relaunch. Supported agent integrations can resume from their saved session IDs. Those are reconstructed app state and resume commands; they do not keep arbitrary live processes running. Use cmux local-tmux for live local detach/reattach across cmux quit, crashes, and updates. A local tmux server cannot survive logout, restart, shutdown, or power loss; use cmux ssh-tmux, cmux mosh-tmux, or a persistent cloud VM when the owner must remain online while this Mac is offline. See session restore and docs/local-tmux.md.

How does it compare to tmux?

tmux is a terminal multiplexer that runs inside any terminal. cmux is a native macOS app with a GUI: vertical tabs, split panes, an embedded browser, and a socket API, all built in, no config files or prefix keys needed. That said, lots of people happily run cmux with SSH and tmux together, and cmux can attach to your remote tmux sessions natively (beta).

Is cmux free?

Yes, cmux is free to use. The source code is available on GitHub.

How can I support cmux?

cmux is free and open source, and always will be. If you want to back development and get early access to what's next, including cmux AI, the iOS app, and Cloud VMs, check out cmux Pro.

I have a feature request or found a bug?

We want to hear it. Open an issue or pull request on GitHub, or email us.

Star History

Star History Chart

Contributing

New here? Start here is the short path from "I want to change something" to a merged pull request, including what you can fix without a Mac. Then the contributor guide and fast local checks.

Ways to get involved:

Community

WeChat: Scan the QR code to join the community.
WeChat QR code to join the cmux community

cmux Pro

cmux is free, open source, and always will be. If you'd like to support development and get early access to what's coming next:

Get cmux Pro

Install

DMG (recommended)

Download cmux for macOS

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.

License

cmux is open source under GPL-3.0-or-later. The cmux server software (web/, the Cloudflare workers, and the relay services listed in LICENSE) uses the Business Source License 1.1 instead: you can read, modify, and run it for non-production use, and production use or self-hosting requires a commercial license.

If your organization cannot comply with GPL, commercial terms may be available for portions for which Manaflow controls the necessary rights. They do not relicense third-party material or outside contributions for which Manaflow lacks a separate grant. See LICENSE for the exact scope and contact [email protected] for details.

View on GitHub

Recent activity

commits and pull requests

Releases and announcements

396 total
  1. Nightly (cmux-next)nightly-nextOct 4, 2026pre-release2.7K downloads

    <!-- cmux-published-sha: ebf8d69c1610f34dfb5f209dae97ac42d2c5a7d1 --> Automated nightly build for `ebf8d69` from `nightly-next`. Published commit: `ebf8d69c1610f34dfb5f209dae97ac42d2c5a7d1`. Built at the commit whose cmux-tui tree is published (app and daemon from one commit); branch tip `ebf8d69c1610f34dfb5f209dae97ac42d2c5a7d1`, 0 commits and 0 h behind it. **cmux NIGHTLY** ships for Apple silicon only (bundle ID `com.cmuxterm.app.nightly`): - [Apple silicon: cmux-nightly-next-macos-arm64.dmg](https://github.com/manaflow-ai/cmux/releases/download/nightly-next/cmux-nightly-next-macos-arm64.dmg), feed `appcast-arm64.xml` ### PRs in this build - [#43842](https://github.com/manaflow-ai/cmux/pull/43842) hot-verify: stop the lag FFI check crashing on the removed NATIVE_IN_TUI - [#43818](https://github.com/manaflow-ai/cmux/pull/43818) MaskedScreenshotTests: remove the push transition by kCATransition 1 commit without a PR number not listed.

  2. cmux nightly 4373846342901nightlyFeb 15, 2026pre-release2K downloads

    <!-- cmux-published-build: 4373846342901 --> <!-- cmux-published-sha: 4b7d3fc195c83a53f7828a8a345b5d4203df2d12 --> ## What changed No product PRs merged since the previous published build. Infrastructure: 1 [Compare published builds](https://github.com/manaflow-ai/cmux/compare/33dd2204cff5b0bf971dd47ed7cc0005a02fbebc...4b7d3fc195c83a53f7828a8a345b5d4203df2d12) ## Downloads - [Apple silicon: cmux-nightly-macos-arm64.dmg](https://github.com/manaflow-ai/cmux/releases/download/nightly/cmux-nightly-macos-arm64.dmg), feed `appcast-arm64.xml` - [Intel: cmux-nightly-macos-x86_64.dmg](https://github.com/manaflow-ai/cmux/releases/download/nightly/cmux-nightly-macos-x86_64.dmg), feed `appcast-x86_64.xml` - [Universal: cmux-nightly-macos.dmg](https://github.com/manaflow-ai/cmux/releases/download/nightly/cmux-nightly-macos.dmg), feed `appcast.xml`

  3. cmux-app-ffi-fcd50f439039123ef3e0425d74655159d4011798cmux-app-ffi-fcd50f439039123ef3e0425d74655159d4011798Nov 15, 2026pre-release409 downloads

    The cmux app FFI (remote desktop core + sidebar layout reducer) as CCmuxAppFFI.xcframework (one dynamic library, libcmux_app_ffi.dylib, universal macOS arm64/x86_64). Source fcd50f439039123ef3e0425d74655159d4011798. SwiftPM binaryTarget checksum (SHA-256 of the zip): 8d472bb220a0321d0a462ee04bca9d4ccccaf56faa9d046ed323b94f1b607f4a

  4. cmux-app-ffi-e238ea5486824ff4fc766954d4bc91d37b90af0ccmux-app-ffi-e238ea5486824ff4fc766954d4bc91d37b90af0cNov 15, 2026pre-release190 downloads

    The cmux app FFI (remote desktop core + sidebar layout reducer) as CCmuxAppFFI.xcframework (one dynamic library, libcmux_app_ffi.dylib, universal macOS arm64/x86_64). Source e238ea5486824ff4fc766954d4bc91d37b90af0c. SwiftPM binaryTarget checksum (SHA-256 of the zip): db104d85476a00c042f5199730d3e69a491fdcc3fd39263e9d201159592cdcbe

  5. cmux-app-ffi-b22d2aebe904648ad36a2cb1b64f4a24236e6b85cmux-app-ffi-b22d2aebe904648ad36a2cb1b64f4a24236e6b85Nov 15, 2026pre-release457 downloads

    The cmux app FFI (remote desktop core + sidebar layout reducer) as CCmuxAppFFI.xcframework (one static library, universal macOS arm64/x86_64). Source b22d2aebe904648ad36a2cb1b64f4a24236e6b85. SwiftPM binaryTarget checksum (SHA-256 of the zip): 9a3a2c0449eb00219fcfeeb7039711f3024e5f1bf99f64858389c29316a40771

Commits per week

last 52 weeks
32030Week of 2025-11-23: 0 commitsWeek of 2025-11-30: 0 commitsWeek of 2025-12-07: 0 commitsWeek of 2025-12-14: 0 commitsWeek of 2025-12-21: 0 commitsWeek of 2025-12-28: 0 commitsWeek of 2026-01-04: 0 commitsWeek of 2026-01-11: 0 commitsWeek of 2026-01-18: 25 commitsWeek of 2026-01-25: 88 commitsWeek of 2026-02-01: 20 commitsWeek of 2026-02-08: 94 commitsWeek of 2026-02-15: 358 commitsWeek of 2026-02-22: 428 commitsWeek of 2026-03-01: 236 commitsWeek of 2026-03-08: 316 commitsWeek of 2026-03-15: 250 commitsWeek of 2026-03-22: 202 commitsWeek of 2026-03-29: 199 commitsWeek of 2026-04-05: 182 commitsWeek of 2026-04-12: 89 commitsWeek of 2026-04-19: 59 commitsWeek of 2026-04-26: 287 commitsWeek of 2026-05-03: 186 commitsWeek of 2026-05-10: 234 commitsWeek of 2026-05-17: 546 commitsWeek of 2026-05-24: 500 commitsWeek of 2026-05-31: 1042 commitsWeek of 2026-06-07: 615 commitsWeek of 2026-06-14: 326 commitsWeek of 2026-06-21: 240 commitsWeek of 2026-06-28: 481 commitsWeek of 2026-07-05: 781 commitsWeek of 2026-07-12: 328 commitsWeek of 2026-07-19: 703 commitsWeek of 2026-07-26: 559 commitsWeek of 2026-08-02: 1091 commitsWeek of 2026-08-09: 1009 commitsWeek of 2026-08-16: 673 commitsWeek of 2026-08-23: 1258 commitsWeek of 2026-08-30: 690 commitsWeek of 2026-09-06: 835 commitsWeek of 2026-09-13: 1419 commitsWeek of 2026-09-20: 3203 commitsWeek of 2026-09-27: 1432 commitsWeek of 2026-10-04: 751 commitsWeek of 2026-10-11: 511 commitsWeek of 2026-10-18: 488 commitsWeek of 2026-10-25: 559 commitsWeek of 2026-11-01: 211 commitsWeek of 2026-11-08: 220 commitsWeek of 2026-11-15: 22 commitsNov 23, 2025Nov 15, 2026
23.7K commits in the last 52 weeks.

When work happens

weekday and hour
SunMonTueWedThuFriSat036912151821Sun 0:00 — 121 commitsSun 1:00 — 137 commitsSun 2:00 — 137 commitsSun 3:00 — 157 commitsSun 4:00 — 119 commitsSun 5:00 — 142 commitsSun 6:00 — 111 commitsSun 7:00 — 122 commitsSun 8:00 — 95 commitsSun 9:00 — 122 commitsSun 10:00 — 107 commitsSun 11:00 — 130 commitsSun 12:00 — 103 commitsSun 13:00 — 61 commitsSun 14:00 — 91 commitsSun 15:00 — 81 commitsSun 16:00 — 137 commitsSun 17:00 — 191 commitsSun 18:00 — 169 commitsSun 19:00 — 166 commitsSun 20:00 — 160 commitsSun 21:00 — 199 commitsSun 22:00 — 193 commitsSun 23:00 — 152 commitsMon 0:00 — 133 commitsMon 1:00 — 116 commitsMon 2:00 — 158 commitsMon 3:00 — 137 commitsMon 4:00 — 117 commitsMon 5:00 — 59 commitsMon 6:00 — 39 commitsMon 7:00 — 55 commitsMon 8:00 — 51 commitsMon 9:00 — 52 commitsMon 10:00 — 42 commitsMon 11:00 — 46 commitsMon 12:00 — 65 commitsMon 13:00 — 91 commitsMon 14:00 — 116 commitsMon 15:00 — 145 commitsMon 16:00 — 130 commitsMon 17:00 — 132 commitsMon 18:00 — 124 commitsMon 19:00 — 143 commitsMon 20:00 — 142 commitsMon 21:00 — 168 commitsMon 22:00 — 150 commitsMon 23:00 — 169 commitsTue 0:00 — 162 commitsTue 1:00 — 143 commitsTue 2:00 — 141 commitsTue 3:00 — 153 commitsTue 4:00 — 100 commitsTue 5:00 — 79 commitsTue 6:00 — 64 commitsTue 7:00 — 51 commitsTue 8:00 — 48 commitsTue 9:00 — 40 commitsTue 10:00 — 33 commitsTue 11:00 — 58 commitsTue 12:00 — 93 commitsTue 13:00 — 103 commitsTue 14:00 — 98 commitsTue 15:00 — 101 commitsTue 16:00 — 154 commitsTue 17:00 — 171 commitsTue 18:00 — 154 commitsTue 19:00 — 140 commitsTue 20:00 — 153 commitsTue 21:00 — 239 commitsTue 22:00 — 177 commitsTue 23:00 — 176 commitsWed 0:00 — 161 commitsWed 1:00 — 155 commitsWed 2:00 — 126 commitsWed 3:00 — 87 commitsWed 4:00 — 102 commitsWed 5:00 — 86 commitsWed 6:00 — 71 commitsWed 7:00 — 48 commitsWed 8:00 — 40 commitsWed 9:00 — 66 commitsWed 10:00 — 61 commitsWed 11:00 — 92 commitsWed 12:00 — 91 commitsWed 13:00 — 108 commitsWed 14:00 — 136 commitsWed 15:00 — 234 commitsWed 16:00 — 261 commitsWed 17:00 — 193 commitsWed 18:00 — 226 commitsWed 19:00 — 209 commitsWed 20:00 — 138 commitsWed 21:00 — 187 commitsWed 22:00 — 176 commitsWed 23:00 — 119 commitsThu 0:00 — 126 commitsThu 1:00 — 100 commitsThu 2:00 — 132 commitsThu 3:00 — 135 commitsThu 4:00 — 140 commitsThu 5:00 — 111 commitsThu 6:00 — 46 commitsThu 7:00 — 39 commitsThu 8:00 — 24 commitsThu 9:00 — 34 commitsThu 10:00 — 37 commitsThu 11:00 — 48 commitsThu 12:00 — 45 commitsThu 13:00 — 73 commitsThu 14:00 — 83 commitsThu 15:00 — 132 commitsThu 16:00 — 128 commitsThu 17:00 — 160 commitsThu 18:00 — 149 commitsThu 19:00 — 178 commitsThu 20:00 — 187 commitsThu 21:00 — 223 commitsThu 22:00 — 197 commitsThu 23:00 — 150 commitsFri 0:00 — 134 commitsFri 1:00 — 150 commitsFri 2:00 — 150 commitsFri 3:00 — 126 commitsFri 4:00 — 123 commitsFri 5:00 — 98 commitsFri 6:00 — 66 commitsFri 7:00 — 77 commitsFri 8:00 — 39 commitsFri 9:00 — 36 commitsFri 10:00 — 32 commitsFri 11:00 — 40 commitsFri 12:00 — 60 commitsFri 13:00 — 96 commitsFri 14:00 — 107 commitsFri 15:00 — 111 commitsFri 16:00 — 136 commitsFri 17:00 — 133 commitsFri 18:00 — 124 commitsFri 19:00 — 118 commitsFri 20:00 — 134 commitsFri 21:00 — 125 commitsFri 22:00 — 130 commitsFri 23:00 — 117 commitsSat 0:00 — 63 commitsSat 1:00 — 69 commitsSat 2:00 — 78 commitsSat 3:00 — 75 commitsSat 4:00 — 77 commitsSat 5:00 — 36 commitsSat 6:00 — 24 commitsSat 7:00 — 21 commitsSat 8:00 — 14 commitsSat 9:00 — 18 commitsSat 10:00 — 20 commitsSat 11:00 — 23 commitsSat 12:00 — 30 commitsSat 13:00 — 25 commitsSat 14:00 — 31 commitsSat 15:00 — 55 commitsSat 16:00 — 72 commitsSat 17:00 — 97 commitsSat 18:00 — 107 commitsSat 19:00 — 117 commitsSat 20:00 — 109 commitsSat 21:00 — 140 commitsSat 22:00 — 149 commitsSat 23:00 — 156 commits
Commit volume by weekday and hour (UTC). Larger dots mean more commits.
DateListRankStars gained
Oct 8, 2026daily#6+50
Oct 7, 2026daily#6+50
May 24, 2026daily#21+97
May 23, 2026daily#16+103
Feb 21, 2026daily#12+188
Feb 20, 2026daily#14+135
  • morluto/rea

    Reverse engineer anything with agents, from app behavior down to native binaries.

    471.6K stars · TypeScript

  • affaan-m/ECC

    The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

    307.9K stars · JavaScript

  • NousResearch/hermes-agent

    The agent that grows with you

    265K stars · Python

  • n8n-io/n8n

    Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

    211.6K stars · TypeScript

  • yt-dlp/yt-dlp

    A feature-rich command-line audio/video downloader

    209.4K stars · Python

  • DietrichGebert/ponytail

    Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

    195.7K stars · JavaScript