What do you want to do?
3 use cases
-
See at a glance which coding agent is waiting for you
Install Cmux and its agent hooks so waiting agents light up with a blue ring and a notification.
View prompt
Install manaflow-ai/cmux with Homebrew, run cmux hooks setup for Claude Code and Codex, and open three workspaces for <tasks>. Confirm that a waiting agent shows the blue ring and appears in the notification panel.
-
Run Claude Code teammate mode with one command
Use Cmux claude-teams so teammates spawn as native splits with sidebar metadata and notifications.
View prompt
In manaflow-ai/cmux, start cmux claude-teams for <project> with teammates for <roles>, and tell me which split each teammate is in and what branch it is on.
-
Give an agent a workspace on a remote machine over SSH
Create a Cmux workspace on a remote box where browser panes reach the remote localhost.
- REPO
manaflow-ai/cmux - Claude Code
- Codex
- Software and DevOps
- Intermediate
View prompt
Using manaflow-ai/cmux, create an SSH workspace on <host>, start my coding agent there on <task>, open a browser pane on the remote dev server at localhost:<port>, and report when the agent needs input.
- REPO
Quick start with Cmux
- Check you have what it needs: macOS; Homebrew or the DMG installer; Optional: your existing Ghostty config for themes and fonts.
- Open manaflow-ai/cmux on GitHub and read the README and license.
- Run
brew tap manaflow-ai/cmuxandbrew install --cask cmux - Run
cmux hooks setupto install hooks for supported agents it finds - For Codex or OpenCode run
cmux hooks setup codexorcmux hooks setup --agent opencode - Start your agents in separate workspaces and splits
These steps come from our top use case, See at a glance which coding agent is waiting for you, which also has a copy-paste agent prompt.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for manaflow-ai/cmux
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forDevelopers on macOS who run several Claude Code, Codex or OpenCode sessions at once and keep losing track of which one is waiting.
- Why it is hot29k stars, picked up by one AI source we track
- LanguageSwift
- Sourcegithub.com/manaflow-ai/cmux · Back to Hot repos
Requirements
- macOS
- Homebrew or the DMG installer
- Optional: your existing Ghostty config for themes and fonts
Add this badge to your README
Maintain Cmux? Show readers where to find these use cases.
Markdown
[](https://dedupedai.com/use-cases/manaflow-ai-cmux/?utm_source=github&utm_medium=badge&utm_campaign=manaflow-ai-cmux)
HTML
<a href="https://dedupedai.com/use-cases/manaflow-ai-cmux/?utm_source=github&utm_medium=badge&utm_campaign=manaflow-ai-cmux"><img src="https://dedupedai.com/badge/manaflow-ai/cmux.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about Cmux
What is Cmux?
cmux is a native macOS terminal built on Ghostty for people running many AI coding agents. Vertical tabs show each workspace's git branch, PR status, ports and latest notification; panes get a blue ring when an agent needs you; an in-app browser has a scriptable API ported from agent-browser; and everything is scriptable through a CLI and socket API, including SSH workspaces and one-command Claude Code Teams. It is an open-source project on GitHub: https://github.com/manaflow-ai/cmux.
How do I use Cmux?
Run brew tap manaflow-ai/cmux and brew install --cask cmux; then run cmux hooks setup to install hooks for supported agents it finds; For Codex or OpenCode run cmux hooks setup codex or cmux hooks setup --agent opencode. The use cases on this page give the full steps and a copy-paste agent prompt for each job.
Who is Cmux for?
Developers on macOS who run several Claude Code, Codex or OpenCode sessions at once and keep losing track of which one is waiting.
What can I do with Cmux?
3 use cases so far, for example: See at a glance which coding agent is waiting for you; Run Claude Code teammate mode with one command; Give an agent a workspace on a remote machine over SSH. Each has steps and a copy-paste agent prompt.
What do I need to run Cmux?
macOS; Homebrew or the DMG installer; Optional: your existing Ghostty config for themes and fonts.
What are alternatives to Cmux?
Other hot AI repos in Software and DevOps: Deep Infer, Harness2, Orca, Opencode, Graphify.
Is Cmux safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.