# ListAgents Tool

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

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** ListAgents, /list-agents

## Think of it like

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

## 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

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

## Example code

```text
/list-agents
```

See which agents this session can reach.

## Why it matters

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

## Common mistake

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

## Three principles

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

## Related terms

- [SendMessage Tool](https://learn.benibix.com/term/ai/send-message-tool)
- [Remote Control](https://learn.benibix.com/term/ai/remote-control)
- [Agent Teams](https://learn.benibix.com/term/ai/agent-teams)

## Taught in

- [Claude Code Subagents](https://learn.benibix.com/learn/ai-claude-code/claude-code-subagents): Claude Code, 15/16

![The main session starts subagents with the Agent tool, messages other sessions, and stops background work.](https://learn.benibix.com/diagrams/ct-agent-tools.svg)

---

Source: https://learn.benibix.com/term/ai/list-agents-tool
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
