Claude Code Adds Cross-Session Messaging

Anthropic released cross-session messaging in Claude Code v2.1.224 on August 7, enabling eligible sessions on macOS and Linux to exchange text messages. Anthropic's documentation says the feature uses ListAgents to discover reachable sessions and SendMessage to deliver findings, warnings, questions, and status updates, while preserving existing permission prompts for actions that require approval.
Anthropic released cross-session messaging for Claude Code in version v2.1.224, allowing Claude Code sessions on the same machine to discover and exchange text messages. The feature is available on macOS and Linux, requires version 2.1.224 or later, and is enabled automatically when a session meets the applicable requirements, according to Anthropic's documentation.
The release introduces two tools: ListAgents, which identifies reachable Claude Code agents, and SendMessage, which delivers a text message to a selected agent. Anthropic describes messages as text written by one Claude instance to another, rather than conversation histories or files. The company directs users needing to move full context between sessions to use its separate session-transfer mechanism.
Coordination across parallel sessions
Anthropic documents several intended uses for the feature:
- •Passing a finding or decision from one session to another session affected by it.
- •Coordinating work in separate Git worktrees for the same repository.
- •Requesting status from long-running work, such as migrations or test runs.
- •Replying to a message received from a Claude Code session on another machine or through Remote Control.
The cross-machine behavior is limited. Anthropic's documentation states that a session on another machine or on the web can reply to an existing exchange, but cannot initiate one. Within an individual session or team, SendMessage can also address subagents and teammates.
9to5Mac reported that the update is designed for users running multiple Claude Code sessions simultaneously, particularly where separate sessions are working on different areas of one project. Anthropic's documentation gives an example in which one session can warn another after a change breaks an assumption in the second session's work, or send an answer after resolving a question that had blocked another task.
Permissions remain session-local
Cross-session messages do not bypass Claude Code's action-approval model. 9to5Mac reported that messages cannot approve permission requests or change configurations. Commands such as /compact arrive as plain text, rather than being executed as commands, and a receiving session still asks the user for approval if acting on a message needs permission.
Classmethod's testing report on v2.1.224 describes new crossSessionInbound and dialogExpiry settings. It reports that messages sent to a running session that would bypass permissions are held pending approval, while messages to other sessions are delivered automatically. The same report characterizes the release as containing 31 changes, including a new self-hosted runner capability and Remote Control-related updates, although those features are separate from cross-session messaging.
For engineering teams, the practical value is less about shared agent memory than about reducing manual relay work between independently steered sessions. In comparable multi-agent workflows, explicit message passing can help communicate repository-level changes and unblock parallel tasks, but it also leaves important controls intact: messages are not file transfers, do not carry entire chat histories, and cannot silently authorize privileged operations. Teams using multiple worktrees or long-running agent tasks can therefore evaluate the feature as a coordination channel rather than as a replacement for source control, review, or permission boundaries.
Key Points
- 1Claude Code v2.1.224 adds text-based coordination between eligible macOS and Linux sessions, reducing manual handoffs during parallel development work.
- 2The feature exposes ListAgents for discovery and SendMessage for delivery, while excluding conversation histories and file transfer from messages.
- 3Permission prompts remain enforced, a design that preserves approval boundaries when sessions exchange instructions or status updates.
Scoring Rationale
Cross-session messaging is a useful workflow enhancement for developers running parallel Claude Code tasks, especially across worktrees and long-running jobs. It is an incremental product capability rather than a new model, API platform, or broadly disruptive infrastructure release.
Sources
Primary source and supporting public references used for this report.
Practice interview problems based on real data
1,625 SQL & Python problems across 15 industry datasets — the exact type of data you work with.
Try 250 free problems


