tmux teammate-mode non-functional in v2.1.76 (fish shell, macOS)
Resolved 💬 3 comments Opened Mar 15, 2026 by yungweng Closed Mar 19, 2026
Description
tmux teammate-mode does not work in Claude Code v2.1.76. Teammates launch in split panes but fail to receive or process instructions from the lead session.
Environment
- Claude Code version: 2.1.76
- OS: macOS (Darwin 25.3.0)
- Shell: fish
- tmux: installed and running
- teammate-mode setting:
"tmux"
Expected Behavior
When using "teammate-mode": "tmux", spawned teammate agents should:
- Open in tmux split panes
- Receive their initial instructions from the lead session
- Execute tasks and communicate results back
Actual Behavior
Teammates launch in tmux split panes but appear disconnected from the lead's messaging system. They either:
- Sit idle at the prompt without processing any instructions
- Never receive their initial mailbox message
Possibly Related Issues
- #24771 — Teammates disconnected from messaging system
- #24108 — Teammates stuck at idle prompt
- #23527 —
pane-base-index≥ 1 causes silent failure - #25375 — Shell compatibility issues
These issues suggest the problem has persisted across multiple versions. The partial fix in v2.1.33 ("Fixed agent teammate sessions in tmux to send and receive messages") does not appear to have fully resolved the underlying issue.
Steps to Reproduce
- Set
"teammate-mode": "tmux"in Claude Code settings - Run Claude Code inside a tmux session on macOS with fish shell
- Trigger a task that spawns teammate agents
- Observe that teammates launch but do not process instructions
Additional Context
pane-base-indexis at default (0)- The issue may be related to fish shell compatibility, but the broader pattern across the related issues suggests a more fundamental messaging problem
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗