Cmux-plugin

Cmux-plugin is a Claude Code integration plugin for cmux, the native macOS terminal built for AI coding agents. It teaches Claude to use cmux features automatically: naming workspaces, sending notifications, reporting progress, and opening browser splits for visual verification.

When not running inside cmux, the plugin silently no-ops. Safe to leave installed everywhere.

• Auto workspace naming — renames the cmux sidebar tab to your git repo + branch on every session start
• Completion notifications — fires cmux notifications when Claude or a sub-agent finishes, so you know when to look
• Sidebar progress bars — teaches Claude to report long-running task progress as a live bar in the cmux sidebar
• Browser split automation — Claude opens a browser split pane when it needs to visually verify a dev server or debug UI
• Superpowers integration — when the Superpowers plugin triggers using-git-worktrees, Claude opens a new cmux workspace for the branch automatically
• Slash commands — /cmux:status for workspace info, /cmux:open-browser for manual browser splits

• macOS 14.0+
• cmux installed via brew tap manaflow-ai/cmux && brew install --cask cmux
• cmux CLI symlinked: sudo ln -sf "/Applications/cmux.app/Contents/Resources/bin/cmux" /usr/local/bin/cmux
• jq installed (brew install jq)

Install from the Patchoutech marketplace:

1. /plugin marketplace add hopchouinard/patchoutech-plugins
2. /plugin install cmux@patchoutech-plugins
3. /reload-plugins

Claude detects cmux via the CMUX_WORKSPACE_ID environment variable. Inside cmux, it will automatically name workspaces, maintain progress bars during long tasks, open browser splits for verification, and send notifications at genuine handoff points.