Support cmux alongside tmux for OMC team mode

[Yeachan-Heo]

Summary

Add cmux compatibility for omc team / legacy /omc-teams so team workflows can launch and operate correctly when OMC is running inside cmux, not only inside a classic tmux session.

Problem

Recent cmux support landed for the main OMC CLI launch path, but team mode still hard-requires $TMUX and documents an active tmux session as a prerequisite.

Current team runtime surfaces still assume a real tmux session:

• skills/omc-teams/SKILL.md says an active tmux session is required
• src/team/tmux-session.ts is documented/implemented around $TMUX-anchored topology creation
• cmux environments may expose their own surface/session context without behaving like a directly attachable tmux terminal

Result: normal omc launch can behave correctly in cmux, while omc team / /omc-teams still fail or reject the environment.

Goal

Support cmux alongside tmux for team-mode entry and worker topology orchestration, without regressing existing tmux behavior.

Proposed scope

1. Detect cmux explicitly in the team runtime / preflight path
2. Decide the correct topology strategy for cmux:
   • reuse compatible pane/window semantics if available, or
   • fall back to a detached/shared session strategy that still preserves team coordination
3. Update team preflight and error messaging so cmux is not misreported as “not inside tmux”
4. Add focused tests for team preflight / topology selection in cmux vs tmux vs plain terminal
5. Update skills/omc-teams/SKILL.md and related docs to reflect the new support contract

Acceptance criteria

• omc team ... no longer hard-rejects cmux solely because $TMUX is absent
• existing tmux team flows continue to work unchanged
• plain non-tmux/non-cmux terminals still fail with a clear prerequisite message when team mode truly needs a multiplexer surface
• automated tests cover cmux detection and launch-policy branching for team mode

Notes

This is separate from the already-merged main CLI cmux launch fix. That work covered the single-session OMC launcher path, not the tmux-backed team runtime.

[Yeachan-Heo]

Picking this up now. I'm opening an OMX implementation session to wire cmux-aware team preflight/topology handling, then I'll follow up here with the PR.

—
[repo owner's gaebal-gajae (clawdbot) 🦞]

[Yeachan-Heo]

Opened PR #1750 against dev for the cmux-aware team-mode fix.

PR: #1750

Implemented the minimal runtime change by classifying team launch surfaces as tmux/cmux/plain-terminal in src/team/tmux-session.ts and routing cmux through the existing detached tmux-session fallback, plus targeted tests/docs updates.

Verification run:

• npm test -- --run src/cli/__tests__/tmux-utils.test.ts src/team/__tests__/tmux-session.create-team.test.ts
• npx eslint src/team/tmux-session.ts src/team/__tests__/tmux-session.create-team.test.ts
• npx tsc --noEmit

[Yeachan-Heo]

Opened PR #1750 against \ for the cmux-aware team-mode fix.\n\nPR: https://github.com/Yeachan-Heo/oh-my-claudecode/pull/1750\n\nImplemented the minimal runtime change by classifying team launch surfaces as tmux/cmux/plain-terminal in \ and routing cmux through the existing detached tmux-session fallback, plus targeted tests/docs updates.\n\nVerification run:\n- \

oh-my-claude-sisyphus@4.8.2 test
vitest --run src/cli/tests/tmux-utils.test.ts src/team/tests/tmux-session.create-team.test.ts

RUN v4.0.18 /home/bellman/Workspace/omc-worktrees/fix-issue-1749-cmux-team-mode

✓ src/cli/tests/tmux-utils.test.ts (24 tests) 6ms
✓ src/team/tests/tmux-session.create-team.test.ts (7 tests) 1211ms
✓ creates a detached session when running outside tmux 302ms
✓ uses a detached tmux session when running inside cmux 302ms
✓ anchors context to TMUX_PANE to avoid focus races 302ms
✓ creates a dedicated tmux window when requested 302ms

Test Files 2 passed (2)
Tests 31 passed (31)
Start at 00:24:15
Duration 1.43s (transform 171ms, setup 0ms, import 218ms, tests 1.22s, environment 0ms)\n- \n- \

[Yeachan-Heo]

Fixed in #1750 and merged to .

Team mode now supports cmux alongside tmux instead of hard-rejecting non-$TMUX multiplexer surfaces.

—
[repo owner's gaebal-gajae (clawdbot) 🦞]

[Yeachan-Heo]

Closing as fixed by #1750 on dev.

—
[repo owner's gaebal-gajae (clawdbot) 🦞]