claude-code - 💡(How to fix) Fix [BUG] CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 disables TUI scrollback in v2.1.119 (terminal can't scroll up to view earlier turns) [3 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#53193Fetched 2026-04-26 05:21:58
View on GitHub
Comments
3
Participants
2
Timeline
9
Reactions
0
Timeline (top)
labeled ×5commented ×3cross-referenced ×1

Root Cause

Agent Teams is the workflow for multi-agent dispatch. Losing scrollback in team mode forces a choice: either you have parallel agent dispatch but no conversation history, or you have history but no team. Both are needed in normal workflow.

The differential is so clean (one env var) that it suggests the teams flag toggles a render mode that doesn't go through the same alt-screen-handling code path that `tui: default` configures.

Likely related — same release / same area: #52673 (Ink renderer source leaks in Agent Teams + 2.1.119), #52251 (subagent SendMessage in Agent Teams), #52139 (Ink renderer crashes in spawned teammates).

Fix Action

Fix / Workaround

`tui: default` is set in `~/.claude/settings.json`. The cycle-22 doc notes this was a workaround for the 2.1.89+ alt-screen-buffer issue (#42670). Without the teams flag, the workaround is effective. With the teams flag, the workaround appears to be bypassed/overridden.

  • Claude Code version: 2.1.119
  • Platform: Linux Debian 12 (Raspberry Pi 5, aarch64) running CC server, accessed via SSH
  • Terminal: GNU screen 4.09 wrapper, also reproduced in VS Code remote SSH terminal
  • Settings: `tui: default` (the post-2.1.89 scrollback workaround)
  • Plugins enabled: discord plugin via channels flag

Agent Teams is the workflow for multi-agent dispatch. Losing scrollback in team mode forces a choice: either you have parallel agent dispatch but no conversation history, or you have history but no team. Both are needed in normal workflow.

RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • Searched existing issues (related: #52673, #52251, #52139, #38932 — all Agent-Teams+TUI in 2.1.119, but none specifically about scrollback)
  • Single bug report
  • Latest version (2.1.119)

What's Wrong?

Setting CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 before launching claude in v2.1.119 silently disables terminal scrollback. The user can't scroll up to see earlier turns in the conversation. Mouse wheel and PageUp/PageDown produce no movement past the visible viewport.

The exact same terminal, the exact same launch command WITHOUT the env var, produces a fully-scrollable session.

Repro

Same machine, same terminal (tested in Linux screen wrapper + VS Code integrated terminal — identical behavior in both):

Scroll WORKS: ```bash cd ~/project && \ claude --resume --permission-mode auto --channels "plugin:discord@claude-plugins-official" ```

Scroll BROKEN: ```bash cd ~/project && \ export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 && \ claude --resume --permission-mode auto --channels "plugin:discord@claude-plugins-official" ```

Single-variable differential. Same flags, same session-resume, same terminal. Only the env var differs.

What Should Happen?

Setting the experimental teams flag should not change scrollback behavior. User should be able to scroll up through prior turns in either mode.

Settings.json

`tui: default` is set in `~/.claude/settings.json`. The cycle-22 doc notes this was a workaround for the 2.1.89+ alt-screen-buffer issue (#42670). Without the teams flag, the workaround is effective. With the teams flag, the workaround appears to be bypassed/overridden.

Environment

  • Claude Code version: 2.1.119
  • Platform: Linux Debian 12 (Raspberry Pi 5, aarch64) running CC server, accessed via SSH
  • Terminal: GNU screen 4.09 wrapper, also reproduced in VS Code remote SSH terminal
  • Settings: `tui: default` (the post-2.1.89 scrollback workaround)
  • Plugins enabled: discord plugin via channels flag

Why This Matters

Agent Teams is the workflow for multi-agent dispatch. Losing scrollback in team mode forces a choice: either you have parallel agent dispatch but no conversation history, or you have history but no team. Both are needed in normal workflow.

The differential is so clean (one env var) that it suggests the teams flag toggles a render mode that doesn't go through the same alt-screen-handling code path that `tui: default` configures.

Likely related — same release / same area: #52673 (Ink renderer source leaks in Agent Teams + 2.1.119), #52251 (subagent SendMessage in Agent Teams), #52139 (Ink renderer crashes in spawned teammates).

Workaround (current)

Strip `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` from launch script. Keeps scrollback at the cost of losing the teams MCP server (TeamCreate / TeamDelete / SendMessage). Use one-off `Agent()` dispatches as fallback.

extent analysis

TL;DR

Setting the CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS environment variable likely changes the rendering mode, bypassing the tui: default scrollback workaround.

Guidance

  • Verify that removing the CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS environment variable restores scrollback functionality.
  • Investigate the rendering mode used when the CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS flag is set and how it interacts with the tui: default configuration.
  • Check if there are any other environment variables or configuration options that can be used to enable both Agent Teams and scrollback.
  • Review related issues (#52673, #52251, #52139) for potential clues on how to resolve the conflict between Agent Teams and scrollback.

Notes

The issue seems to be specific to the CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS environment variable and its interaction with the tui: default configuration. Further investigation is needed to determine the root cause and find a solution that enables both Agent Teams and scrollback.

Recommendation

Apply the workaround of stripping the CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 from the launch script, as it keeps scrollback at the cost of losing the teams MCP server, until a more permanent solution is found.

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 [BUG] CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 disables TUI scrollback in v2.1.119 (terminal can't scroll up to view earlier turns) [3 comments, 2 participants]