[DOCS] Agent teams docs still say `Shift+Up/Down` for teammate navigation after v2.1.47 change to `Shift+Down` wrapping
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://code.claude.com/docs/en/agent-teams
Section/Topic
Teammate selection and in-process interaction keyboard guidance
Current Documentation
The page currently states Shift+Up/Down in multiple places:
- "Use Shift+Up/Down to select a teammate and message them directly"
- "In-process: ... Use Shift+Up/Down to select a teammate..."
- "In-process mode: use Shift+Up/Down to select a teammate..."
What's Wrong or Missing?
Claude Code v2.1.47 changed teammate navigation behavior:
- navigation now uses only
Shift+Down(with wrapping) - no dual
Shift+Up+Shift+Downnavigation model
The docs still describe the old key behavior, which leads to incorrect instructions for current versions.
Suggested Improvement
- Replace
Shift+Up/Downreferences withShift+Down (wraps)inagent-teams. - Add a short note describing wrap behavior (last teammate -> first teammate).
- If
Shift+Upnow has no teammate-navigation behavior, explicitly note that to avoid confusion.
Suggested wording:
In-process mode: press Shift+Down to cycle through teammates (wraps from last back to first).
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/agent-teams | 81 | Intro keyboard guidance uses Shift+Up/Down |
| https://code.claude.com/docs/en/agent-teams | 93 | In-process mode section uses Shift+Up/Down |
| https://code.claude.com/docs/en/agent-teams | 153 | Direct teammate messaging section uses Shift+Up/Down |
Release note reference (v2.1.47):
- "Simplified teammate navigation to use only Shift+Down (with wrapping) instead of both Shift+Up and Shift+Down."
Dedup check:
- Open issue #26511 discusses a navigation bug side effect. This issue is specifically about versioned documentation being out of date with the released keybinding behavior.
3 Comments
Plea to Ant: please change the behavior match the doc rather than the other way around!
Why would you disable shift+up?
It's like having a scroll bar that can only go down, but that wraps around. What a weird design. And it wastes the user's time!
Verification (2026-02-19)
This issue has been resolved. The agent teams documentation no longer references
Shift+Up/Down— all teammate navigation instructions now use onlyShift+Downwith wrapping.Evidence
Current references in agent-teams:
No remaining
Shift+Upreferences in teammate navigation context (the onlyShift+Upin the docs is inkeybindings.mdformessageSelector:top, which is unrelated).Status: RESOLVED
Recommendation: CLOSE
This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.