[DOCS] Make the multi-repo Agent View workflow easier to find

Open 💬 0 comments Opened Jun 14, 2026 by andirdju

Documentation Type

Unclear/confusing documentation

Documentation Location

https://code.claude.com/docs/en/agent-view.md

Section/Topic

Dispatch to a specific directory

Current Documentation

  • Documented as one bullet: "Open claude agents in a parent directory that holds several repositories and mention one with @<repo>…"

What's Wrong or Missing?

  • It works and is documented — just buried as a sub-bullet under "Dispatch to a specific directory"
  • Readers searching for "use one Agent View across several repos" won't land there

Suggested Improvement

  • Add a named callout — "Work across multiple repos from one Agent View":
  • open claude agents from the parent folder holding your repos
  • dispatch into any of them with @<repo> <prompt>
  • Ctrl+S to group the list by repo
  • to focus the list on one project, launch with --cwd <repo>
  • Optionally, cross-link it from the quickstart

Impact

Low - Minor confusion or inconvenience

Additional Context

_No response_

View original on GitHub ↗