Skip to content
BENIBIX Learn

SendMessage Tool

AI⌨️ Claude CodeBuilt-in Tools

Also known as SendMessage, Cross-session messaging

It sends a note from one agent to another one.

Think of it like

It is like passing a note to a friend in the next room.

Example

Emma has one session on the front end and one on the server. The server session sends a message saying the new field is ready to use.

Why it matters

Agents can work as a team and hand news to each other, not only to you.

Definition

The SendMessage tool lets Claude send a message to another agent. That can be a teammate in an agent team, a subagent it wants to pick up again, or one of your other Claude Code sessions. The other agent reads the message and can act on it. Messages to other sessions need Claude Code version 2.1.224 or later.
It carries a note from one agent to another.

Common mistake

Expecting a plain subagent to get a message after it has finished. You resume it by its id or name first.

Key takeaways

  1. 1
    Agent to agent. Not only to you.
  2. 2
    Many targets. Teammates, helpers, sessions.
  3. 3
    Lists who to reach. With ListAgents.

Learn it properly