{"id":32774181,"url":"https://github.com/manaflow-ai/cmux","last_synced_at":"2026-05-22T02:13:17.217Z","repository":{"id":335092216,"uuid":"1144115288","full_name":"manaflow-ai/cmux","owner":"manaflow-ai","description":"Ghostty-based terminal with vertical tabs and a notification panel for macOS","archived":false,"fork":false,"pushed_at":"2026-02-12T10:46:49.000Z","size":41440,"stargazers_count":2,"open_issues_count":5,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-12T11:14:57.308Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://term.cmux.dev","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/manaflow-ai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-28T10:03:24.000Z","updated_at":"2026-02-12T04:30:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/manaflow-ai/cmux","commit_stats":null,"previous_names":["manaflow-ai/cmuxterm","manaflow-ai/cmux"],"tags_count":36,"template":false,"template_full_name":null,"purl":"pkg:github/manaflow-ai/cmux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manaflow-ai%2Fcmux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manaflow-ai%2Fcmux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manaflow-ai%2Fcmux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manaflow-ai%2Fcmux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manaflow-ai","download_url":"https://codeload.github.com/manaflow-ai/cmux/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manaflow-ai%2Fcmux/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29444108,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T12:43:28.304Z","status":"ssl_error","status_checked_at":"2026-02-14T12:43:14.160Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-11-04T10:01:25.119Z","updated_at":"2026-03-14T13:22:38.105Z","avatar_url":"https://github.com/manaflow-ai.png","language":"Swift","funding_links":[],"categories":["Music","Swift","Table of Contents","Tool","🚀 AI Tools for Vim, Neovim, and Terminal","GUI \u0026 IDE","TypeScript","AI Tools \u0026 Agent Orchestration","The latest additions 🎉","Parallel Agent Runners","🖥️ Terminal Apps","Reference","amp","Harnesses \u0026 orchestration","🤖 AI \u0026 Machine Learning","AI \u0026 LLM","Terminal","JavaScript"],"sub_categories":["Text","Terminal Emulator","Official Resources","Session managers \u0026 parallel runners","Agents \u0026 Orchestration","Terminal Agents"],"readme":"\u003ch1 align=\"center\"\u003ecmux\u003c/h1\u003e\n\u003cp align=\"center\"\u003eA Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg\"\u003e\n    \u003cimg src=\"./docs/assets/macos-badge.png\" alt=\"Download cmux for macOS\" width=\"180\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  English | \u003ca href=\"README.zh-CN.md\"\u003e简体中文\u003c/a\u003e | \u003ca href=\"README.zh-TW.md\"\u003e繁體中文\u003c/a\u003e | \u003ca href=\"README.ko.md\"\u003e한국어\u003c/a\u003e | \u003ca href=\"README.de.md\"\u003eDeutsch\u003c/a\u003e | \u003ca href=\"README.es.md\"\u003eEspañol\u003c/a\u003e | \u003ca href=\"README.fr.md\"\u003eFrançais\u003c/a\u003e | \u003ca href=\"README.it.md\"\u003eItaliano\u003c/a\u003e | \u003ca href=\"README.da.md\"\u003eDansk\u003c/a\u003e | \u003ca href=\"README.ja.md\"\u003e日本語\u003c/a\u003e | \u003ca href=\"README.pl.md\"\u003ePolski\u003c/a\u003e | \u003ca href=\"README.ru.md\"\u003eРусский\u003c/a\u003e | \u003ca href=\"README.bs.md\"\u003eBosanski\u003c/a\u003e | \u003ca href=\"README.ar.md\"\u003eالعربية\u003c/a\u003e | \u003ca href=\"README.no.md\"\u003eNorsk\u003c/a\u003e | \u003ca href=\"README.pt-BR.md\"\u003ePortuguês (Brasil)\u003c/a\u003e | \u003ca href=\"README.th.md\"\u003eไทย\u003c/a\u003e | \u003ca href=\"README.tr.md\"\u003eTürkçe\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://x.com/manaflowai\"\u003e\u003cimg src=\"https://img.shields.io/badge/@manaflow-555?logo=x\" alt=\"X / Twitter\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://discord.gg/xsgFEVrWCZ\"\u003e\u003cimg src=\"https://img.shields.io/badge/Discord-555?logo=discord\" alt=\"Discord\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./docs/assets/main-first-image.png\" alt=\"cmux screenshot\" width=\"900\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.youtube.com/watch?v=i-WxO5YUTOs\"\u003e▶ Demo video\u003c/a\u003e · \u003ca href=\"https://cmux.dev/blog/zen-of-cmux\"\u003eThe Zen of cmux\u003c/a\u003e\n\u003c/p\u003e\n\n## Features\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"40%\" valign=\"middle\"\u003e\n\u003ch3\u003eNotification rings\u003c/h3\u003e\nPanes get a blue ring and tabs light up when coding agents need your attention\n\u003c/td\u003e\n\u003ctd width=\"60%\"\u003e\n\u003cimg src=\"./docs/assets/notification-rings.png\" alt=\"Notification rings\" width=\"100%\" /\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd width=\"40%\" valign=\"middle\"\u003e\n\u003ch3\u003eNotification panel\u003c/h3\u003e\nSee all pending notifications in one place, jump to the most recent unread\n\u003c/td\u003e\n\u003ctd width=\"60%\"\u003e\n\u003cimg src=\"./docs/assets/sidebar-notification-badge.png\" alt=\"Sidebar notification badge\" width=\"100%\" /\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd width=\"40%\" valign=\"middle\"\u003e\n\u003ch3\u003eIn-app browser\u003c/h3\u003e\nSplit a browser alongside your terminal with a scriptable API ported from \u003ca href=\"https://github.com/vercel-labs/agent-browser\"\u003eagent-browser\u003c/a\u003e\n\u003c/td\u003e\n\u003ctd width=\"60%\"\u003e\n\u003cimg src=\"./docs/assets/built-in-browser.png\" alt=\"Built-in browser\" width=\"100%\" /\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd width=\"40%\" valign=\"middle\"\u003e\n\u003ch3\u003eVertical + horizontal tabs\u003c/h3\u003e\nSidebar shows git branch, linked PR status/number, working directory, listening ports, and latest notification text. Split horizontally and vertically.\n\u003c/td\u003e\n\u003ctd width=\"60%\"\u003e\n\u003cimg src=\"./docs/assets/vertical-horizontal-tabs-and-splits.png\" alt=\"Vertical tabs and split panes\" width=\"100%\" /\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n- **Scriptable** — CLI and socket API to create workspaces, split panes, send keystrokes, and automate the browser\n- **Native macOS app** — Built with Swift and AppKit, not Electron. Fast startup, low memory.\n- **Ghostty compatible** — Reads your existing `~/.config/ghostty/config` for themes, fonts, and colors\n- **GPU-accelerated** — Powered by libghostty for smooth rendering\n\n## Install\n\n### DMG (recommended)\n\n\u003ca href=\"https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg\"\u003e\n  \u003cimg src=\"./docs/assets/macos-badge.png\" alt=\"Download cmux for macOS\" width=\"180\" /\u003e\n\u003c/a\u003e\n\nOpen the `.dmg` and drag cmux to your Applications folder. cmux auto-updates via Sparkle, so you only need to download once.\n\n### Homebrew\n\n```bash\nbrew tap manaflow-ai/cmux\nbrew install --cask cmux\n```\n\nTo update later:\n\n```bash\nbrew upgrade --cask cmux\n```\n\nOn first launch, macOS may ask you to confirm opening an app from an identified developer. Click **Open** to proceed.\n\n## Why cmux?\n\nI 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.\n\nI 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.\n\nThe 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.\n\nThe 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.\n\nEverything is scriptable through the CLI and socket API — create workspaces/tabs, split panes, send keystrokes, open URLs in the browser.\n\n## The Zen of cmux\n\ncmux 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.\n\ncmux 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.\n\nThe 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.\n\nGive a million developers composable primitives and they'll collectively find the most efficient workflows faster than any product team could design top-down.\n\n## Documentation\n\nFor more info on how to configure cmux, [head over to our docs](https://cmux.dev/docs/getting-started?utm_source=readme).\n\n## Keyboard Shortcuts\n\n### Workspaces\n\n| Shortcut | Action |\n|----------|--------|\n| ⌘ N | New workspace |\n| ⌘ 1–8 | Jump to workspace 1–8 |\n| ⌘ 9 | Jump to last workspace |\n| ⌃ ⌘ ] | Next workspace |\n| ⌃ ⌘ [ | Previous workspace |\n| ⌘ ⇧ W | Close workspace |\n| ⌘ ⇧ R | Rename workspace |\n| ⌘ B | Toggle sidebar |\n\n### Surfaces\n\n| Shortcut | Action |\n|----------|--------|\n| ⌘ T | New surface |\n| ⌘ ⇧ ] | Next surface |\n| ⌘ ⇧ [ | Previous surface |\n| ⌃ Tab | Next surface |\n| ⌃ ⇧ Tab | Previous surface |\n| ⌃ 1–8 | Jump to surface 1–8 |\n| ⌃ 9 | Jump to last surface |\n| ⌘ W | Close surface |\n\n### Split Panes\n\n| Shortcut | Action |\n|----------|--------|\n| ⌘ D | Split right |\n| ⌘ ⇧ D | Split down |\n| ⌥ ⌘ ← → ↑ ↓ | Focus pane directionally |\n| ⌘ ⇧ H | Flash focused panel |\n\n### Browser\n\nBrowser developer-tool shortcuts follow Safari defaults and are customizable in `Settings → Keyboard Shortcuts`.\n\n| Shortcut | Action |\n|----------|--------|\n| ⌘ ⇧ L | Open browser in split |\n| ⌘ L | Focus address bar |\n| ⌘ [ | Back |\n| ⌘ ] | Forward |\n| ⌘ R | Reload page |\n| ⌥ ⌘ I | Toggle Developer Tools (Safari default) |\n| ⌥ ⌘ C | Show JavaScript Console (Safari default) |\n\n### Notifications\n\n| Shortcut | Action |\n|----------|--------|\n| ⌘ I | Show notifications panel |\n| ⌘ ⇧ U | Jump to latest unread |\n\n### Find\n\n| Shortcut | Action |\n|----------|--------|\n| ⌘ F | Find |\n| ⌘ G / ⌘ ⇧ G | Find next / previous |\n| ⌘ ⇧ F | Hide find bar |\n| ⌘ E | Use selection for find |\n\n### Terminal\n\n| Shortcut | Action |\n|----------|--------|\n| ⌘ K | Clear scrollback |\n| ⌘ C | Copy (with selection) |\n| ⌘ V | Paste |\n| ⌘ + / ⌘ - | Increase / decrease font size |\n| ⌘ 0 | Reset font size |\n\n### Window\n\n| Shortcut | Action |\n|----------|--------|\n| ⌘ ⇧ N | New window |\n| ⌘ , | Settings |\n| ⌘ ⇧ , | Reload configuration |\n| ⌘ Q | Quit |\n\n## Nightly Builds\n\n[Download cmux NIGHTLY](https://github.com/manaflow-ai/cmux/releases/download/nightly/cmux-nightly-macos.dmg)\n\ncmux 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.\n\n## Session restore (current behavior)\n\nOn relaunch, cmux currently restores app layout and metadata only:\n- Window/workspace/pane layout\n- Working directories\n- Terminal scrollback (best effort)\n- Browser URL and navigation history\n\ncmux does **not** restore live process state inside terminal apps. For example, active Claude Code/tmux/vim sessions are not resumed after restart yet.\n\n## Star History\n\n\u003ca href=\"https://star-history.com/#manaflow-ai/cmux\u0026Date\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=manaflow-ai/cmux\u0026type=Date\u0026theme=dark\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=manaflow-ai/cmux\u0026type=Date\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=manaflow-ai/cmux\u0026type=Date\" width=\"600\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n## Contributing\n\nWays to get involved:\n\n- Follow us on X for updates [@manaflowai](https://x.com/manaflowai), [@lawrencecchen](https://x.com/lawrencecchen), and [@austinywang](https://x.com/austinywang)\n- Join the conversation on [Discord](https://discord.gg/xsgFEVrWCZ)\n- Create and participate in [GitHub issues](https://github.com/manaflow-ai/cmux/issues) and [discussions](https://github.com/manaflow-ai/cmux/discussions)\n- Let us know what you're building with cmux\n\n## Community\n\n- [Discord](https://discord.gg/xsgFEVrWCZ)\n- [GitHub](https://github.com/manaflow-ai/cmux)\n- [X / Twitter](https://twitter.com/manaflowai)\n- [YouTube](https://www.youtube.com/channel/UCAa89_j-TWkrXfk9A3CbASw)\n- [LinkedIn](https://www.linkedin.com/company/manaflow-ai/)\n- [Reddit](https://www.reddit.com/r/cmux/)\n\n## Founder's Edition\n\ncmux is free, open source, and always will be. If you'd like to support development and get early access to what's coming next:\n\n**[Get Founder's Edition](https://buy.stripe.com/3cI00j2Ld0it5OU33r5EY0q)**\n\n- **Prioritized feature requests/bug fixes**\n- **Early access: cmux AI that gives you context on every workspace, tab and panel**\n- **Early access: iOS app with terminals synced between desktop and phone**\n- **Early access: Cloud VMs**\n- **Early access: Voice mode**\n- **My personal iMessage/WhatsApp**\n\n## License\n\nThis project is licensed under the GNU Affero General Public License v3.0 or later (`AGPL-3.0-or-later`).\n\nSee `LICENSE` for the full text.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanaflow-ai%2Fcmux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanaflow-ai%2Fcmux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanaflow-ai%2Fcmux/lists"}