CloudNavi
← Back to articles
Claude Code Cross-Session Messaging Complete Guide 2026: Sessions Can Now Send Messages to Each Other
AI Agents·1 min read
#Claude Code#cross-session messaging#AI coding agent#parallel development#SendMessage

Summary

「I want to tell Claude Code running in another terminal what I just did…」

Claude Code Cross-Session Messaging Complete Guide 2026: Sessions Can Now Send Messages to Each Other


「I want to tell Claude Code running in another terminal what I just did…」 「Copy-pasting handoffs every time is such a pain…」

That problem was solved in August 2026. Claude Code added cross-session messaging — sessions can send messages to each other. The official announcement on X gathered over 55,000 likes, making it a major feature.

Simply put: Claude Code sessions running in separate terminals can now exchange messages. Instead of copy-pasting context between sessions, you just tell Claude "send this to the other session."

This guide fully explains the mechanism, usage, and cautions for beginners.


What you'll learn in this article

  • What cross-session messaging is
  • Why it's impressive (what changes)
  • Concrete usage (with real prompt examples)
  • How messages between sessions are delivered (the mechanism)
  • Security, limitations, and cautions

Why it's impressive: the reason it got 55,000 likes

On August 7, 2026, the Claude Code official account announced:

  • Your sessions can send messages to each other
  • Instead of re-explaining yourself to another session, just tell Claude "send it" and it delivers a summary
  • Only summaries are sent (history and files are not)
  • Bidirectional: you can ask other sessions questions and receive answers
  • Claude can also proactively send messages (e.g. when your changes affect another session's work)

The key point is freeing context handoffs from manual copy-paste. For anyone doing parallel development across multiple terminals, this is a major productivity boost.


What is cross-session messaging?

Mechanism (diagram)

Cross-Session Messaging MechanismSession A (Terminal 1)1. ListAgents: discover sessions2. SendMessage: send a summaryOnly the summary is sentHistory / files are NOT includedSession B (Terminal 2)Receives the messageCan also reply / ask questionsBidirectional communicationClaude may proactively send tooNo more copy-paste handoffs — just tell ClaudeAvailable on macOS / Linux · Claude Code v2.1.224+

How to use it

1. Check that the other session is visible

Run in the terminal:

/list-agents

If other sessions appear, cross-session messaging is enabled.

2. Tell Claude to send a message

Just say it in natural language:

Tell the session working on the API server that I've finished the DB schema changes.

Claude discovers the target session and sends the summary via SendMessage.

3. Ask another session a question

Ask the frontend session what the current state of the component refactor is.

The reply comes back to your session.


Security and limitations

ItemDescription
Only summaries are sentHistory and file contents are never included
Approval not possibleSessions cannot approve each other
Settings cannot be changedCannot modify other sessions' config
Commands are not executedReceiving session does not run commands from the message
AvailabilitymacOS / Linux · Claude Code v2.1.224+

How it differs from other features

PurposeFeature
Continue a conversation in another terminal / share contextresume sessions
Team work generated & supervised by Claudeagent teams
Monitor & operate many sessions on one screenagent view
Operate from another device like a phoneRemote Control
Incorporate external events like CI resultschannels

Summary

Claude Code's cross-session messaging is a feature that dramatically changes productivity for people doing parallel development across multiple terminals.

  • Handoffs to other sessions go from copy-paste to a single instruction
  • Only summaries are sent, so history and files never leak
  • Bidirectional — questions and answers are possible
  • Security restrictions are solid (no approvals, no settings changes, no command execution)
  • Available on macOS / Linux with Claude Code v2.1.224+

The more you run "multiple AI coding agents at once," the more you'll feel the value of this feature. Start by checking /list-agents to see if other sessions are visible, then try it with two terminals.