Support cmux as a terminal backend for agent teams
Resolved 💬 1 comment Opened Mar 5, 2026 by riop01 Closed Mar 5, 2026
Preflight Checklist
- [x] I have searched existing requests and this feature hasn't been requested yet
- [x] This is a single feature request (not multiple features)
Problem Statement
Claude Code agent teams currently only support tmux and iTerm2 as terminal backends for spawning teammate panes. Users of cmux — a native macOS terminal built on Ghostty's rendering engine and designed specifically for AI coding agent workflows — are forced to either:
- Fall back to
in-processmode, losing all pane visibility into teammate activity - Nest tmux inside cmux, adding unnecessary complexity
There is no teammateMode option to use cmux's pane management, despite cmux exposing a CLI and socket API purpose-built for this kind of automation.
Proposed Solution
Add cmux as a supported teammateMode option that:
- Detects cmux availability via its CLI or socket
- Creates split panes for each teammate using the cmux socket/CLI API
- Routes teammate I/O through cmux panes
- Supports the same lifecycle operations (create, monitor, shutdown) as the tmux backend
Configuration would look like:
{
"teammateMode": "cmux"
}
The auto mode should also detect cmux and prefer it when available.
Alternative Solutions
- Nesting tmux inside cmux — works but adds complexity and loses cmux's native features (notification rings, git context in tabs, embedded browser)
- Running separate Claude Code sessions in different cmux workspaces — works but loses unified team coordination
- Using in-process mode — functional but provides no visibility into teammate activity
Priority
Medium - Would be very helpful
Feature Category
Interactive mode (TUI)
Use Case Example
Example scenario:
- I'm working in cmux as my primary terminal, using its vertical tabs and split panes for my workflow
- I spin up a Claude Code agent team to parallelize a task across 3 teammates
- Currently, the teammates either spawn invisibly (in-process) or I have to run tmux inside cmux
- With this feature, each teammate would appear in a native cmux split pane with notification rings showing when they need attention
- This would provide a better UX than tmux panes since cmux shows git branch, working directory, and port info per-pane
Additional Context
- cmux website: https://www.cmux.dev/
- cmux GitHub: https://github.com/manaflow-ai/cmux
- cmux socket API docs: https://www.cmux.dev/docs/api
- cmux already documents integration with Claude Code hooks for notifications, indicating the developers are actively targeting this use case
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗