claude-code - 💡(How to fix) Fix Add cmux support to teammateMode [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#54515Fetched 2026-04-30 06:43:31
View on GitHub
Comments
1
Participants
2
Timeline
5
Reactions
1
Timeline (top)
labeled ×3commented ×1subscribed ×1
RAW_BUFFERClick to expand / collapse

Feature request

Currently teammateMode in settings.json only supports tmux, in-process, and auto (which falls back to in-process when not in a tmux session). It would be useful to add cmux as an additional backend so users running cmux can get the same split-pane experience tmux users get.

Current behavior

  • In a tmux session: teammates spawn in tmux split panes (great UX)
  • In cmux (or any non-tmux multiplexer): falls back to in-process, no split-pane UI

Proposed behavior

  • Add "cmux" as a valid teammateMode enum value
  • Have auto detect cmux sessions and use cmux split panes when available
  • Document the cmux integration alongside tmux/iTerm2

Why

Users who prefer cmux over tmux currently have to either switch multiplexers or lose the split-pane teammate UX. Adding cmux as a first-class backend removes that friction.

Environment

  • macOS (Darwin 25.4.0)
  • Claude Code (current version)

extent analysis

TL;DR

To add support for cmux as a teammate mode, modify the teammateMode enum in settings.json to include "cmux" and implement cmux session detection for the "auto" mode.

Guidance

  • Identify the current implementation of teammateMode in settings.json and the logic behind the "auto" mode to understand how to integrate cmux support.
  • Determine the requirements for detecting a cmux session, potentially involving environment variables or process checks.
  • Update the teammateMode enum to include "cmux" as a valid value and adjust the "auto" mode logic to fall back to cmux when a cmux session is detected.
  • Consider documenting the cmux integration alongside existing tmux and iTerm2 documentation to ensure users are aware of the new feature.

Example

No code example is provided due to the lack of specific implementation details in the issue.

Notes

The solution requires modifications to the existing codebase, specifically the teammateMode enum and the logic for detecting and handling different multiplexer sessions. The exact implementation details may vary depending on the underlying architecture and technology stack of Claude Code.

Recommendation

Apply workaround: Modify the teammateMode enum and implement cmux session detection, as this is a feature request rather than a bug fix, and there is no indication of a fixed version that includes this functionality.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix Add cmux support to teammateMode [1 comments, 2 participants]