[DOCS] Agent teams docs still say `Shift+Up/Down` for teammate navigation after v2.1.47 change to `Shift+Down` wrapping

Status Fixed / completed
Maintainer reply None cached
Activity 3 comments · opened Feb 18, 2026 · closed Feb 20, 2026

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+Down navigation model

The docs still describe the old key behavior, which leads to incorrect instructions for current versions.

Suggested Improvement

  1. Replace Shift+Up/Down references with Shift+Down (wraps) in agent-teams.
  2. Add a short note describing wrap behavior (last teammate -> first teammate).
  3. If Shift+Up now 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.

View original on GitHub ↗

3 Comments

ESRogs · 7 months ago

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!

coygeek · 7 months ago

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 only Shift+Down with wrapping.

Evidence

Current references in agent-teams:

  • Line 81: "Use Shift+Down to cycle through teammates and message them directly. After the last teammate, Shift+Down wraps back to the lead."
  • Line 93: "use Shift+Down to cycle through teammates"
  • Line 145: "use Shift+Down to cycle through teammates"
  • Line 330: "Press Shift+Down to cycle through active teammates"
  • Line 344: "using Shift+Down in in-process mode"

No remaining Shift+Up references in teammate navigation context (the only Shift+Up in the docs is in keybindings.md for messageSelector:top, which is unrelated).

Status: RESOLVED
Recommendation: CLOSE

github-actions[bot] · 7 months ago

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.