Awesome cmux

A curated, opinionated guide to the cmux ecosystem — the Ghostty-based macOS terminal built for AI coding agents. 190+ community projects and growing. This list covers manaflow-ai/cmux only; for the Go connection multiplexer by soheilhy, see that repo directly.

cmux exposes three primitives that the entire plugin ecosystem builds on: CMUX_WORKSPACE_ID, CMUX_SURFACE_ID, and CMUX_SOCKET_PATH. Every project below uses at least one of them.

brew install --cask cmux          # stable
brew install --cask cmux-nightly  # nightly

• Feature Dimensions — primary navigation
  • 1. Sidebar & Status Pills
  • 2. Progress Bars & Estimation
  • 3. Sidebar Logs & Activity Feed
  • 4. Desktop Notifications
  • 5. Multi-Agent Orchestration
  • 6. Browser Automation
  • 7. Worktrees & Workspace Management
  • 8. Monitoring & Session Restore
  • 9. Remote & Mobile Access
  • 10. Themes, Layouts & Config
• By Agent — secondary navigation
  • Claude Code
  • Pi
  • OpenCode
  • Copilot & Amp
• Cross-Platform Ports
• Alternatives
• Build Your Own Plugin
• Reference — official docs, build infra, community

Repos appear in every section they are relevant to. If a project touches sidebar, notifications, and progress, it shows up in all three. This is intentional — browse by the feature you need, not by where someone decided to file it.

cmux's vertical sidebar is the primary surface for agent feedback. Plugins write status pills — small key-value pairs that appear next to each workspace tab. The best ones update on every lifecycle event so you can see model name, token count, thinking state, and active tool at a glance without switching tabs.

Recommended: yigitkonur/cmux-claude-pro for Claude Code (16 hooks, most complete), kdcokenny/ocx for OpenCode (520 stars, production-proven), HazAT/pi-config for Pi (228 stars, full multi-agent setup).

Long-running agent tasks need visible progress. cmux's sidebar supports progress bars that fill from 0-100%. The best plugins estimate completion dynamically — some use logarithmic curves, others count completed todo items. Without progress bars, you are left guessing whether an agent is stuck or just thinking hard.

Recommended: yigitkonur/cmux-claude-pro for adaptive progress estimation, HazAT/pi-interactive-subagents for cross-multiplexer live TUI progress, 0xCaso/opencode-cmux for todo-driven progress tracking.

The sidebar can show scrolling log entries — timestamped messages about what the agent is doing. Logs are essential for debugging: you can see which tools were called, which files were edited, and where errors occurred without switching to the agent's pane. The entries here differ meaningfully in what they capture, how they handle high-frequency events, and whether they correlate logs to external systems.

When an agent finishes a task, hits an error, or needs permission, you want to know immediately — even if cmux is behind another window. Plugins use cmux notify or OSC 777 escape sequences to fire native macOS notifications. The best ones are focus-aware: they stay quiet when you are already looking at the workspace.

Recommended: kdcokenny/opencode-notify for OpenCode (standalone, 127 stars), sasha-computer/pi-cmux for Pi (context-aware summaries).

Running multiple agents in parallel is cmux's superpower. An orchestrator agent splits panes, launches workers, sends them tasks, and monitors their output via read-screen. The best frameworks handle the full lifecycle: spawn, dispatch, poll for completion, collect results, and tear down. This section includes both ready-to-use frameworks and skill files that teach your agent how to orchestrate.

Recommended: manaflow-ai/manaflow (997 stars, broadest agent coverage across VS Code workspaces), HazAT/pi-interactive-subagents (251 stars, works across cmux/tmux/zellij), dagster-io/erk for plan-oriented workflows with PR automation.

Frameworks

MCP Servers

Orchestration Skills (teach your agent how to orchestrate)

cmux embeds a WebKit browser pane that agents can control via CLI. Plugins use cmux browser for navigation, DOM interaction, screenshots, form filling, and JavaScript evaluation. The best ones expose the full 40+ subcommand surface. This is how agents can visually verify their work, run E2E tests, or display rich content alongside the terminal.

Recommended: azu/cmux-hub for the highest-starred diff viewer with CI status (★15), sasha-computer/pi-cmux for the best all-round Pi browser toolkit (★14), jasonraz/cmux-browser-mcp for MCP-based browser control (43 tools).

Git worktrees give each agent an isolated copy of the repository on a separate branch — no merge conflicts, no stepping on each other's changes. The best plugins create a worktree, open a cmux workspace for it, launch an agent inside, and clean up when the branch merges. This is the foundation for safe parallel development.

Recommended: craigsc/cmux (477 stars, tmux-based gold standard for worktree UX), kdcokenny/opencode-worktree (392 stars, most popular OpenCode option), aschreifels/cwt for Claude Code with ticket integration.

Agents can run for hours. When cmux restarts, crashes, or you close the lid, you need to pick up exactly where you left off. Session restore plugins snapshot running sessions and recreate them. Monitoring plugins give you a bird's-eye view of what every agent is doing across all workspaces.

Recommended: STRML/cmux-restore for Claude Code session mapping, drolosoft/cmux-resurrect for full workspace restore with Markdown blueprints.

Sometimes you need to check on your agents from another room — or another device entirely. These projects bridge cmux to mobile apps, web browsers, and SSH sessions.

The right layout turns cmux from a terminal into a development cockpit. Three-pane setups with a file browser, agent, and git sidebar are popular. Themes set the mood; config tweaks (scrollback, opacity, key bindings) make everything feel right.

Cross-reference tables organized by the agent you use. Tags tell you which features each repo covers so you can pick exactly what you need.

Hooks & Sidebar Plugins

Skills (reference docs that teach Claude Code how to use cmux)

Orchestration & Worktrees

Session Restore & Monitoring

Layout & Config

These projects work across multiple agents or are agent-agnostic.

Projects that solve similar problems without requiring the cmux application itself.

• llv22/cmux_forward — Add working-directory restore for Bash sessions. One patch over upstream. Swift
• israeligal/cmux-file-explorer — Add a file explorer sidebar, native text editor, and CWD sync between explorer and terminal panes. Swift

cmux's plugin surface is intentionally simple: a Unix socket, a CLI, and environment variables. Every workspace gets CMUX_WORKSPACE_ID, CMUX_SURFACE_ID, and CMUX_SOCKET_PATH injected into its environment. Your plugin reads those vars, connects to the socket, and starts sending JSON-RPC messages.

The main integration points:

• Sidebar status pills — set key-value pairs that appear next to workspace tabs
• Progress bars — update a 0-100% bar in the sidebar
• Sidebar logs — write timestamped messages to a scrolling feed
• Desktop notifications — fire cmux notify or OSC 777 escape sequences
• Browser automation — control the embedded WebKit browser via cmux browser subcommands
• Pane management — split, send, read-screen, and manage surfaces via cmux CLI
• Workspace lifecycle — create, rename, switch, and close workspaces programmatically

For a detailed walkthrough of the sidebar integration API, see docs/sidebar-integration-api.md.

For the full CLI and socket protocol reference, see the Documentation section or the self-contained docs:

• API Reference — full CLI and socket JSON-RPC protocol
• Browser Automation — 40+ subcommands for the embedded WebKit browser
• Notifications — CLI, OSC 777/99, and agent hook integration
• SSH — remote workspaces with browser proxying and notification relay
• AppleScript Automation Guide — 10-part deep-dive covering CLI wrappers, socket v2, and automation recipes

Comprehensive self-contained reference docs mirrored from cmux.com/docs — see the full index.

Core

API & Automation

Agent Integrations

• Ghostty (docs · config · source) — the terminal engine under cmux
• agent-browser — Vercel's browser automation, integrated into cmux · ★31850

cmux reads ~/.config/ghostty/config automatically. Below is a production config optimized for multi-agent workflows.

# NOTE: macos-option-as-alt breaks Option+key chars on non-US keyboards (e.g. @ on Turkish layout)
theme = Catppuccin Mocha
background = 1e1e2e
foreground = cdd6f4
cursor-color = f5e0dc
cursor-text = 1e1e2e
cursor-style = block
cursor-style-blink = false
cursor-opacity = 0.9
selection-background = 585b70
selection-foreground = cdd6f4
font-family = JetBrainsMono Nerd Font
font-family-bold = JetBrainsMono Nerd Font
font-family-italic = JetBrainsMono Nerd Font
font-family-bold-italic = JetBrainsMono Nerd Font
font-size = 16
font-thicken = true
font-thicken-strength = 64
font-feature = calt
font-feature = liga
font-codepoint-map = U+2500-U+259F=Menlo
background-opacity = 0.95
background-blur = macos-glass-regular
window-padding-x = 16
window-padding-y = 12
window-padding-balance = true
window-padding-color = extend
window-height = 35
window-width = 120
macos-titlebar-style = transparent
window-decoration = auto
window-theme = dark
window-colorspace = display-p3
window-save-state = always
window-show-tab-bar = never
unfocused-split-opacity = 0.65
unfocused-split-fill = 181825
split-divider-color = 45475a
split-inherit-working-directory = true
tab-inherit-working-directory = true
window-inherit-working-directory = true
window-inherit-font-size = true
scrollback-limit = 50000
clipboard-read = allow
clipboard-write = allow
clipboard-trim-trailing-spaces = true
clipboard-paste-protection = true
clipboard-paste-bracketed-safe = true
copy-on-select = clipboard
shell-integration = zsh
shell-integration-features = no-cursor
term = xterm-256color
confirm-close-surface = false
macos-option-as-alt = true
macos-non-native-fullscreen = true
focus-follows-mouse = false
resize-overlay = after-first
resize-overlay-position = bottom-right
resize-overlay-duration = 500ms
cursor-click-to-move = true
scroll-to-bottom = keystroke, no-output
keybind = alt+left=esc:b
keybind = alt+right=esc:f
keybind = cmd+left=text:\x01
keybind = cmd+right=text:\x05
keybind = alt+backspace=text:\x17
keybind = cmd+k=clear_screen
keybind = cmd+d=new_split:right
keybind = cmd+shift+d=new_split:down
keybind = cmd+alt+left=goto_split:left
keybind = cmd+alt+right=goto_split:right
keybind = cmd+alt+up=goto_split:top
keybind = cmd+alt+down=goto_split:bottom
keybind = cmd+ctrl+left=resize_split:left,20
keybind = cmd+ctrl+right=resize_split:right,20
keybind = cmd+ctrl+up=resize_split:up,10
keybind = cmd+ctrl+down=resize_split:down,10
keybind = cmd+shift+e=equalize_splits
keybind = cmd+shift+z=toggle_split_zoom
keybind = cmd+equal=increase_font_size:2
keybind = cmd+minus=decrease_font_size:2
keybind = cmd+0=reset_font_size
keybind = cmd+shift+comma=reload_config
keybind = cmd+enter=toggle_fullscreen
palette = 0=#45475a
palette = 8=#585b70
palette = 1=#f38ba8
palette = 9=#f38ba8
palette = 2=#a6e3a1
palette = 10=#a6e3a1
palette = 3=#f9e2af
palette = 11=#f9e2af
palette = 4=#89b4fa
palette = 12=#89b4fa
palette = 5=#f5c2e7
palette = 13=#f5c2e7
palette = 6=#94e2d5
palette = 14=#94e2d5
palette = 7=#bac2de
palette = 15=#a6adc8

• How to Scriptize cmux: CLI, AppleScript, Raw Sockets

Show HN · r/ClaudeCode intro · r/ClaudeCode vertical tabs

Official Demo Video · Product Hunt · YC (Manaflow) · UBOS · Digg · Microlaunch

These repositories have been deleted or are no longer accessible.

• adhyaay-karnwal/cmux — Abandoned fork with Docker isolation and multi-CLI support. TypeScript
• ctaho19/cmux-cursor-work-style — Repository deleted. Previously contained a Cursor aesthetic theme with charcoal/blue colors and Berkeley Mono

Before opening a PR, verify your entry:

1. Public repo with a README
2. Uses a cmux API — CMUX_SOCKET_PATH, cmux CLI, socket protocol, or cmux env vars
3. Themes/configs must include at least one cmux-specific feature
4. Description — start with a verb, 30-50 words, neutral tone, no superlatives
5. Format — [owner/repo](url) | \tag` | description | Lang · ★N`
6. Placement — add the repo to every feature dimension section it belongs in, plus the correct agent section

See CONTRIBUTING.md for the full style guide.

MIT — see LICENSE.