Skip to content
Back to search

cmux

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/manaflow-ai/cmux with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/manaflow-ai/cmux'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/manaflow-ai-cmux/badge.svg)](/listings/manaflow-ai-cmux)

HTML

<a href="/listings/manaflow-ai-cmux"><img src="/api/listings/manaflow-ai-cmux/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

DMG (recommended)

<a href="https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg"> </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

On first launch, macOS may ask you to confirm opening an app from an identified developer. Click **Open** to proceed.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 546 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <h1 align="center">cmux</h1>
  2. <p align="center">A Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents</p>
  3. <p align="center">
  4. <a href="https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg">
  5. <img src="./docs/assets/macos-badge.png" alt="Download cmux for macOS" width="180" />
  6. </a>
  7. </p>
  8. <p align="center">
  9. 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>
  10. </p>
  11. <p align="center">
  12. <a href="https://x.com/manaflowai"><img src="https://img.shields.io/badge/@manaflow-555?logo=x" alt="X / Twitter" /></a>
  13. <a href="https://discord.gg/xsgFEVrWCZ"><img src="https://img.shields.io/badge/Discord-555?logo=discord" alt="Discord" /></a>
  14. <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>
  15. </p>
  16. <p align="center">
  17. <img src="./docs/assets/main-first-image.png" alt="cmux screenshot" width="900" />
  18. </p>
  19. <p align="center">
  20. <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>
  21. </p>
  22. <p align="center">
  23. <a href="https://cmux.com/docs/getting-started">Docs</a> · <a href="https://cmux.com/blog">Blog</a> · <a href="https://cmux.com/docs/changelog">Changelog</a> · <a href="https://cmux.com/community">Community</a>
  24. </p>
  25. ## Features
  26. <table>
  27. <tr>
  28. <td width="40%" valign="middle">
  29. <h3>Notification rings</h3>
  30. Panes get a blue ring and tabs light up when coding agents need your attention
  31. </td>
  32. <td width="60%">
  33. <img src="./docs/assets/notification-rings.png" alt="Notification rings" width="100%" />
  34. </td>
  35. </tr>
  36. <tr>
  37. <td width="40%" valign="middle">
  38. <h3>Notification panel</h3>
  39. See all pending notifications in one place, jump to the most recent unread
  40. </td>
  41. <td width="60%">
  42. <img src="./docs/assets/sidebar-notification-badge.png" alt="Sidebar notification badge" width="100%" />
  43. </td>
  44. </tr>
  45. <tr>
  46. <td width="40%" valign="middle">
  47. <h3>In-app browser</h3>
  48. Split a browser alongside your terminal with a scriptable API ported from <a href="https://github.com/vercel-labs/agent-browser">agent-browser</a>
  49. </td>
  50. <td width="60%">
  51. <img src="./docs/assets/built-in-browser.png" alt="Built-in browser" width="100%" />
  52. </td>
  53. </tr>
  54. <tr>
  55. <td width="40%" valign="middle">
  56. <h3>Vertical + horizontal tabs</h3>
  57. Sidebar shows git branch, linked PR status/number, working directory, listening ports, and latest notification text. Split horizontally and vertically.
  58. </td>
  59. <td width="60%">
  60. <img src="./docs/assets/vertical-horizontal-tabs-and-splits.png" alt="Vertical tabs and split panes" width="100%" />
  61. </td>
  62. </tr>
  63. <tr>
  64. <td width="40%" valign="middle">
  65. <h3>SSH</h3>
  66. <code>cmux 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.
  67. </td>
  68. <td width="60%">
  69. <img src="./docs/assets/ssh.png" alt="cmux SSH" width="100%" />
  70. </td>
  71. </tr>
  72. <tr>
  73. <td width="40%" valign="middle">
  74. <h3>Claude Code Teams</h3>
  75. <code>cmux 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.
  76. </td>
  77. <td width="60%">
  78. <img src="./docs/assets/claude-code-teams.png" alt="Claude Code Teams" width="100%" />
  79. </td>
  80. </tr>
  81. </table>
  82. - **Browser import** — Import cookies, history, and sessions from Chrome, Firefox, Arc, and 20+ browsers so browser panes start authenticated
  83. - **Custom commands** — Define project-specific actions in [`cmux.json`](https://cmux.com/docs/custom-commands) that launch from the command palette
  84. - **Programmable** — CLI and socket API to create workspaces, split panes, send keystrokes, and automate the browser
  85. - **Native macOS app** — Built with Swift and AppKit, not Electron. Fast startup, low memory.
  86. - **Ghostty compatible** — Reads your existing `~/.config/ghostty/config` for themes, fonts, and colors
  87. - **GPU-accelerated** — Powered by libghostty for smooth rendering
  88. - **Keyboard shortcuts** — [Extensive shortcuts](https://cmux.com/docs/keyboard-shortcuts) for workspaces, splits, browser, and more
  89. - **Open source** — Free and GPL-licensed
  90. ## Install
  91. ### DMG (recommended)
  92. <a href="https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg">
  93. <img src="./docs/assets/macos-badge.png" alt="Download cmux for macOS" width="180" />
  94. </a>
  95. Open the `.dmg` and drag cmux to your Applications folder. cmux auto-updates via Sparkle, so you only need to download once.
  96. ### Homebrew
  97. ```bash
  98. brew tap manaflow-ai/cmux
  99. brew install --cask cmux
  100. ```
  101. To update later:
  102. ```bash
  103. brew upgrade --cask cmux
  104. ```
  105. On first launch, macOS may ask you to confirm opening an app from an identified developer. Click **Open** to proceed.
  106. ### Shell completion
  107. 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](https://docs.brew.sh/Shell-Completion)).
  108. If you installed cmux another way, add the matching line to your shell startup file, then start a new shell:
  109. ```zsh
  110. autoload -Uz compinit && compinit
  111. eval "$(cmux completion zsh)"
  112. ```
  113. ```bash
  114. eval "$(cmux completion bash)"
  115. ```
  116. ```fish
  117. cmux completion fish | source
  118. ```
  119. ## Why cmux?
  120. 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.
  121. 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.
  122. 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.
  123. The in-app browser has a scriptable API ported from [agent-browser](https://github.com/vercel-labs/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.
  124. Everything is scriptable through the CLI and socket API — create workspaces/tabs, split panes, send keystrokes, open URLs in the browser.
  125. ## The Zen of cmux
  126. 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.
  127. 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.
  128. 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.
  129. Give a million developers composable primitives and they'll collectively find the most efficient workflows faster than any product team could design top-down.
  130. ## Documentation
  131. For more info on how to configure cmux, [head over to our docs](https://cmux.com/docs/getting-started?utm_source=readme).
  132. To theme cmux (colors, fonts, transparency, sidebar, and more), see [Customizing cmux's look](docs/customizing-appearance.md).
  133. For shell watcher churn and managed-Mac process audit volume, see the supported
  134. [`CMUX_NO_GIT_WATCH=1` mitigation](docs/shell-integration.md) and its Git/PR update trade-offs.
  135. ## Keyboard Shortcuts
  136. ### Workspaces
  137. | Shortcut | Action |
  138. |----------|--------|
  139. | ⌘ N | New local workspace |
  140. | ⌘ Y | New Cloud workspace on the last usable Cloud context; opens New Cloud Machine when none is available |
  141. | ⌘ ⇧ Y | New Cloud machine |
  142. | ⌘ 1–8 | Jump to workspace 1–8 |
  143. | ⌘ 9 | Jump to last workspace |
  144. | ⌃ ⌘ ] | Next workspace |
  145. | ⌃ ⌘ [ | Previous workspace |
  146. | ⌘ ⇧ W | Close workspace |
  147. | ⌘ ⇧ R | Rename workspace |
  148. | ⌥ ⌘ E | Edit workspace description |
  149. | ⌘ B | Toggle sidebar |
  150. | ⌥ ⌘ B | Toggle right sidebar |
  151. | ⌘ ⇧ E | Toggle right sidebar focus |
  152. ### Surfaces
  153. | Shortcut | Action |
  154. |----------|--------|
  155. | ⌘ T | New surface |
  156. | ⌘ ⇧ ] | Next surface |
  157. | ⌘ ⇧ [ | Previous surface |
  158. | ⌃ Tab | Next surface |
  159. | ⌃ ⇧ Tab | Previous surface |
  160. | ⌃ 1–8 | Jump to surface 1–8 |
  161. | ⌃ 9 | Jump to last surface |
  162. | ⌘ W | Close surface |
  163. ### Split Panes
  164. | Shortcut | Action |
  165. |----------|--------|
  166. | ⌘ D | Split right |
  167. | ⌘ ⇧ D | Split down |
  168. | ⌥ ⌘ ← → ↑ ↓ | Focus pane directionally |
  169. | ⌃ ⇧ H J K L | Resize pane left/down/up/right |
  170. | ⌘ ⇧ H | Flash focused panel |
  171. ### Browser
  172. Browser developer-tool shortcuts follow Safari defaults and are customizable in `Settings → Keyboard Shortcuts`.
  173. Command palette navigation shortcuts, including ⌃ P, are also customizable and can be cleared so the keypress reaches the active terminal.
  174. | Shortcut | Action |
  175. |----------|--------|
  176. | ⌘ ⇧ L | Open browser in split |
  177. | ⌘ L | Focus address bar |
  178. | ⌘ [ | Back |
  179. | ⌘ ] | Forward |
  180. | ⌘ R | Reload page |
  181. | ⌥ ⌘ I | Toggle Developer Tools (Safari default) |
  182. | ⌥ ⌘ C | Show JavaScript Console (Safari default) |
  183. ### Notifications
  184. | Shortcut | Action |
  185. |----------|--------|
  186. | ⌘ I | Show notifications panel |
  187. | ⌘ ⇧ U | Jump to latest unread |
  188. | ⌥ ⌘ U | Toggle current item unread state |
  189. | ⌃ ⌘ U | Mark current item as oldest unread and jump to next latest unread |
  190. | — | Mark all notifications read (unbound by default; configure in Settings or `cmux.json`) |
  191. | — | Clear all notifications (unbound by default; configure in Settings or `cmux.json`) |
  192. ### Find
  193. | Shortcut | Action |
  194. |----------|--------|
  195. | ⌘ F | Find |
  196. | ⌘ ⇧ F | Find in directory |
  197. | ⌘ G / ⌥ ⌘ G | Find next / previous |
  198. | ⌥ ⌘ ⇧ F | Hide find bar |
  199. | ⌘ E | Use selection for find |
  200. ### Terminal
  201. | Shortcut | Action |
  202. |----------|--------|
  203. | ⌘ K | Clear scrollback |
  204. | ⌘ C | Copy (with selection) |
  205. | ⌘ V | Paste |
  206. | ⌘ + / ⌘ - | Increase / decrease font size |
  207. | ⌘ 0 | Reset font size |
  208. ### Window
  209. | Shortcut | Action |
  210. |----------|--------|
  211. | ⌘ ⇧ N | New window |
  212. | ⌘ ⇧ O | Reopen previous session |
  213. | ⌘ , | Settings |
  214. | ⌘ ⇧ , | Reload configuration |
  215. | ⌘ Q | Quit |
  216. ## Nightly Builds
  217. [Download cmux NIGHTLY](https://github.com/manaflow-ai/cmux/releases/download/nightly/cmux-nightly-macos.dmg) (universal; updates then switch to your Mac's architecture automatically)
  218. 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.
  219. Report nightly bugs on [GitHub Issues](https://github.com/manaflow-ai/cmux/issues) or in [#nightly-bugs on Discord](https://discord.gg/xsgFEVrWCZ).
  220. ## Session restore
  221. Quitting cmux saves the current session. On relaunch, cmux restores app-owned
  222. state:
  223. - Window/workspace/pane layout
  224. - Working directories
  225. - Terminal scrollback (best effort)
  226. - Browser URL and navigation history
  227. cmux does not checkpoint arbitrary live process state. Ordinary terminals,
  228. tmux, vim, shells, and unsupported terminal apps reopen as normal terminals.
  229. For live detach/reattach across cmux quit, crashes, and updates, opt in to the
  230. local tmux owner with `cmux local-tmux`; see [`docs/local-tmux.md`](docs/local-tmux.md)
  231. for its lifecycle and machine-sleep limits. zellij users can use `cmux local-zellij`
  232. instead; see [`docs/local-zellij.md`](docs/local-zellij.md).
  233. Supported agent sessions can resume when hooks have saved a native session ID.
  234. Install hooks after installing the agent CLI so its binary is on `PATH`:
  235. ```bash
  236. cmux hooks setup
  237. cmux hooks setup codex
  238. cmux hooks setup --agent opencode
  239. ```
  240. `cmux hooks setup` installs supported agents it can find and prints a summary
  241. for skipped agents. Supported resume integrations include Claude Code, Codex,
  242. Grok, OpenCode, Pi, Amp, Cursor CLI, Gemini, Rovo Dev, Copilot, CodeBuddy,
  243. Factory, and Qoder. Claude Code is handled by the cmux Claude wrapper when Claude
  244. integration is enabled in Settings.
  245. Advanced users and integrations can attach a custom resume command to the
  246. current terminal surface. This is useful for tools with their own durable state,
  247. such as tmux sessions or custom agent CLIs:
  248. ```bash
  249. cmux surface resume set --kind tmux --checkpoint work --shell "tmux attach -t work"
  250. cmux surface resume show --json
  251. cmux surface resume clear --checkpoint work
  252. ```
  253. The binding stays attached to the cmux surface. Public CLI or socket-created
  254. bindings are stored for inspection and manual restore unless you approve a
  255. signed command prefix for automatic restore. Approved prefixes are also bound to
  256. the working directory and exact environment values, when present. Review or edit
  257. approvals in **Settings > Terminal > Resume Commands**. cmux only auto-runs
  258. resume bindings it marks trusted, such as live process-detected tmux bindings or
  259. user-approved prefixes. Sensitive environment keys such as tokens, passwords,
  260. secrets, and API keys are dropped before a resume binding is stored.
  261. To keep restored agent terminals idle instead of automatically running their resume commands,
  262. turn off **Settings > Terminal > Resume Agent Sessions on Reopen** or set this in
  263. `~/.config/cmux/cmux.json`:
  264. ```json
  265. {
  266. "terminal": {
  267. "autoResumeAgentSessions": false
  268. }
  269. }
  270. ```
  271. This only disables automatic agent resume commands. cmux still restores the saved layout,
  272. working directories, scrollback, and browser history.
  273. If you need to reapply the last saved snapshot manually, use:
  274. - `File > Reopen Previous Session`
  275. - `⌘ ⇧ O`
  276. - `cmux restore-session`
  277. Each cmux install (stable, nightly, rc, staging, and tagged debug builds) keeps its own
  278. saved session. To bring a session from one install into another, for example after trying
  279. nightly and switching back to stable, run this from the install you want to open it in:
  280. ```bash
  281. cmux restore-session --from nightly # or stable, rc, staging, debug:<tag>
  282. cmux restore-session --export ~/session.json # write this install's saved session to a file
  283. cmux restore-session --export ~/session.json --force # replace an existing export file
  284. cmux restore-session --from ~/session.json # reopen an exported file
  285. ```
  286. The imported session opens as additional windows next to the ones you have, like
  287. `cmux restore-session`; the other install's saved file is only read. Agent resume carries
  288. over because hook session mappings in `~/.cmuxterm/` are shared by every install. Browser
  289. cookies and logins are per install and do not move.
  290. `--from <channel>` restores another install's own session file with the same trust as your
  291. own session, including automatic agent resume. `--from <path>` treats the file as untrusted:
  292. layout, working directories, text scrollback, and http(s) browser tabs restore, but nothing in
  293. the file runs automatically. Built-in agents (Claude Code, Codex, Amp, and the rest) resume with
  294. the command cmux builds from the agent kind and session id, ignoring launch arguments stored in
  295. the file, and only when the working directory already exists on this Mac. Custom agent resume
  296. commands, resume bindings, and tmux start commands are kept for manual restore only (approved
  297. resume prefixes never apply to them): the CLI reports how many were held back, and in each
  298. terminal `cmux surface resume show` shows the command and `cmux restore --surface` runs it.
  299. Terminal control sequences in the scrollback (clipboard, notifications, links, titles), draft
  300. attachments, non-http(s) browser pages and profiles, SSH/cloud connections, and workspace
  301. environment variables from the file are dropped. A snapshot saved by a newer cmux
  302. (newer session format) is refused with an error; if a downgraded cmux finds one in its own
  303. session file, it keeps a copy next to it as `session-<bundle id>.schema-v<N>.json`.
  304. Under the hood, cmux writes a versioned snapshot under
  305. `~/Library/Application Support/cmux/` and agent hooks write session mappings
  306. under `~/.cmuxterm/`. On restore, cmux rebuilds the layout first, then runs the
  307. supported agent's native resume command when automatic agent resume is enabled.
  308. Read the full guide at <https://cmux.com/docs/session-restore>.
  309. ## FAQ
  310. ### How does cmux relate to Ghostty?
  311. cmux is not a fork of Ghostty. It uses [libghostty](https://github.com/ghostty-org/ghostty) 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.
  312. ### What platforms does it support?
  313. macOS only, for now. cmux is a native Swift + AppKit app.
  314. ### Is there an iOS app?
  315. 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](https://cmux.com/api/billing/checkout?plan=pro). See the [iOS docs](https://cmux.com/docs/ios).
  316. ### What coding agents does cmux work with?
  317. 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.
  318. ### Can cmux orchestrate multiple agents and subagents?
  319. 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](https://cmux.com/docs/agent-integrations/claude-code-teams) and [oh-my-opencode](https://cmux.com/docs/agent-integrations/oh-my-opencode) multi-model orchestration, so every agent in a run is visible and controllable.
  320. ### Can I use cmux with remote machines?
  321. 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](https://cmux.com/docs/ssh).
  322. ### How do notifications work?
  323. 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](https://cmux.com/docs/notifications#cli-usage) and [agent hooks](https://cmux.com/docs/notifications#integration-examples). Any agent that supports hooks or OSC works, including Claude Code, Codex, OpenCode, and pi.
  324. ### Is cmux programmable?
  325. 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](https://cmux.com/docs/api) and [browser automation](https://cmux.com/docs/browser-automation) docs.
  326. ### What can the built-in browser do?
  327. 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](https://cmux.com/docs/browser-automation).
  328. ### Does cmux have skills?
  329. 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](https://github.com/manaflow-ai/cmux-skills), or read the [skills docs](https://cmux.com/docs/skills).
  330. ### Can I customize keyboard shortcuts?
  331. 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](docs/ghostty-keybindings.md). cmux-specific shortcuts (workspaces, splits, browser, notifications) can be customized in Settings. See the [default shortcuts](https://cmux.com/docs/keyboard-shortcuts) for a full list.
  332. ### Can I customize cmux?
  333. 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](https://cmux.com/docs/keyboard-shortcuts) is editable. See [configuration](https://cmux.com/docs/configuration).
  334. ### Are my sessions saved?
  335. cmux restores windows, workspaces, panes, working directories, and best-effort
  336. scrollback when you relaunch. Supported agent integrations can resume from
  337. their saved session IDs. Those are reconstructed app state and resume commands;
  338. they do not keep arbitrary live processes running. Use `cmux local-tmux` for
  339. live local detach/reattach across cmux quit, crashes, and updates. A local tmux
  340. server cannot survive logout, restart, shutdown, or power loss; use
  341. `cmux ssh-tmux`, `cmux mosh-tmux`, or a persistent cloud VM when the owner must
  342. remain online while this Mac is offline. See [session restore](https://cmux.com/docs/session-restore)
  343. and [`docs/local-tmux.md`](docs/local-tmux.md).
  344. ### How does it compare to tmux?
  345. 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](https://cmux.com/docs/remote-tmux)).
  346. ### Is cmux free?
  347. Yes, cmux is free to use. The source code is available on [GitHub](https://github.com/manaflow-ai/cmux).
  348. ### How can I support cmux?
  349. 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](https://cmux.com/api/billing/checkout?plan=pro).
  350. ### I have a feature request or found a bug?
  351. We want to hear it. Open an [issue](https://github.com/manaflow-ai/cmux/issues) or [pull request](https://github.com/manaflow-ai/cmux/pulls) on GitHub, or [email us](mailto:founders@cmux.com?subject=cmux%20feature%20request).
  352. ## Star History
  353. <a href="https://www.star-history.com/?repos=manaflow-ai%2Fcmux&type=date&legend=top-left">
  354. <picture>
  355. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=manaflow-ai/cmux&type=date&theme=dark&legend=top-left&sealed_token=N5E-Mdh7zIesE2fP9_q8wEZyOg3un2Ki7u61afJnUUu6ZIUEUsrH_dsPrA8CWrw12owIEezjOyhDiXcfIEoSzAlIybOqvxTk-xCpuXbpnFk86SkJzfErObW1u0MrAuLp-_tXZDM1kAMI2jMtAeXZK3_VEe2HH9dNyhXxgMTCns6c7lMmCJ_kSIgtooYf" />
  356. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=manaflow-ai/cmux&type=date&legend=top-left&sealed_token=N5E-Mdh7zIesE2fP9_q8wEZyOg3un2Ki7u61afJnUUu6ZIUEUsrH_dsPrA8CWrw12owIEezjOyhDiXcfIEoSzAlIybOqvxTk-xCpuXbpnFk86SkJzfErObW1u0MrAuLp-_tXZDM1kAMI2jMtAeXZK3_VEe2HH9dNyhXxgMTCns6c7lMmCJ_kSIgtooYf" />
  357. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=manaflow-ai/cmux&type=date&legend=top-left&sealed_token=N5E-Mdh7zIesE2fP9_q8wEZyOg3un2Ki7u61afJnUUu6ZIUEUsrH_dsPrA8CWrw12owIEezjOyhDiXcfIEoSzAlIybOqvxTk-xCpuXbpnFk86SkJzfErObW1u0MrAuLp-_tXZDM1kAMI2jMtAeXZK3_VEe2HH9dNyhXxgMTCns6c7lMmCJ_kSIgtooYf" />
  358. </picture>
  359. </a>
  360. ## Contributing
  361. New here? [Start here](docs/start-here.md) is the short path from "I want to
  362. change something" to a merged pull request, including what you can fix without a
  363. Mac. Then the [contributor guide](CONTRIBUTING.md) and
  364. [fast local checks](CONTRIBUTING.md#fast-checks-before-building-or-pushing).
  365. Ways to get involved:
  366. - Follow us on X for updates [@manaflowai](https://x.com/manaflowai), [@lawrencecchen](https://x.com/lawrencecchen), and [@austinywang](https://x.com/austinywang)
  367. - Join the conversation on [Discord](https://discord.gg/xsgFEVrWCZ)
  368. - Create and participate in [GitHub issues](https://github.com/manaflow-ai/cmux/issues) and [discussions](https://github.com/manaflow-ai/cmux/discussions)
  369. - Let us know what you're building with cmux
  370. ## Community
  371. - [Discord](https://discord.gg/xsgFEVrWCZ)
  372. - [WhatsApp](https://chat.whatsapp.com/Fblh7FB58lOI2cx6ccdIqY?mode=gi_t)
  373. - [GitHub](https://github.com/manaflow-ai/cmux)
  374. - [X / Twitter](https://twitter.com/manaflowai)
  375. - [YouTube](https://www.youtube.com/channel/UCAa89_j-TWkrXfk9A3CbASw)
  376. - [LinkedIn](https://www.linkedin.com/company/manaflow-ai/)
  377. - [Reddit](https://www.reddit.com/r/cmux/)
  378. <p>
  379. <strong>WeChat:</strong> Scan the QR code to join the community.<br />
  380. <img src="./docs/assets/wechat-community-qr.jpg" alt="WeChat QR code to join the cmux community" width="240" />
  381. </p>
  382. ## cmux Pro
  383. 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:
  384. **[Get cmux Pro](https://cmux.com/api/billing/checkout?plan=pro)**
  385. ## Install
  386. ### DMG (recommended)
  387. <a href="https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg">
  388. <img src="./docs/assets/macos-badge.png" alt="Download cmux for macOS" width="180" />
  389. </a>
  390. Open the `.dmg` and drag cmux to your Applications folder. cmux auto-updates via Sparkle, so you only need to download once.
  391. ### Homebrew
  392. ```bash
  393. brew tap manaflow-ai/cmux
  394. brew install --cask cmux
  395. ```
  396. To update later:
  397. ```bash
  398. brew upgrade --cask cmux
  399. ```
  400. On first launch, macOS may ask you to confirm opening an app from an identified developer. Click **Open** to proceed.
  401. ## License
  402. cmux is open source under [GPL-3.0-or-later](LICENSE). The cmux server software (`web/`, the Cloudflare workers, and the relay services listed in [LICENSE](LICENSE)) uses the [Business Source License 1.1](web/LICENSE) instead: you can read, modify, and run it for non-production use, and production use or self-hosting requires a commercial license.
  403. If your organization cannot comply with GPL, commercial terms may be available
  404. for portions for which Manaflow controls the necessary rights. They do not
  405. relicense third-party material or outside contributions for which Manaflow
  406. lacks a separate grant. See [LICENSE](LICENSE) for the exact scope and contact
  407. [founders@cmux.com](mailto:founders@cmux.com) for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.