Skip to content
BENIBIX Learn

ListAgents Tool

AI⌨️ Claude CodeBuilt-in Tools

Also known as ListAgents, /list-agents

The tool that lists the agents Claude can send messages to.

Think of it like

It is like the list of names on a class phone tree.

Example

Lucy forgets the name of her other session. Claude lists the agents, finds it, and sends it the note she wanted to pass on.

Why it matters

Claude can only message an agent it can find, so this is the first step.

Definition

The ListAgents tool lists each agent Claude can send a message to. That means the subagents in the session, the teammates in an agent team and your other Claude Code sessions on this computer. With Remote Control on, it also lists your cloud sessions and sessions on other computers. It is what the /list-agents command shows. It needs version 2.1.224 or later.

Example code

text
/list-agents
See which agents this session can reach.
ListAgents shows who SendMessage can reach.

Common mistake

Expecting it to show sessions on other computers all the time. They only show up when Remote Control is on.

Key takeaways

  1. 1
    Who can be reached. One list.
  2. 2
    Local and beyond. With Remote Control.
  3. 3
    Pairs with SendMessage. Find, then send.

Learn it properly