Cross-Session Messaging in Claude Code
Claude Code sessions can now send each other a summary of what they are working on, so you do not have to re-explain a task in a second session.
Details
- One session sends the other a written summary of the task, not your conversation history and not your files
- The receiving session picks the message up mid-task rather than waiting until it finishes what it is doing
- Sessions find each other with a ListAgents tool and send with SendMessage, and they can reach sessions running on any of your machines
- Messages sent into a session that is running with permission checks turned off are held for your approval first, while messages to normal sessions deliver automatically
- Two new settings, crossSessionInbound and dialogExpiry, control that approval behavior
- Shipped in Claude Code v2.1.224 for macOS and Linux including WSL 2, with no native Windows support yet
Best for
Running several Claude Code sessions at once and needing one to hand work off to another
When to use it
A long job is running in one session and you want to keep working in another without retyping the context by hand
Who benefits
Developers who keep multiple Claude Code sessions open across projects or machines
Join the newsletter to get ahead with AI.
I share strategies, new modules, free guides, and tools to get you better at using AI in your work.
Leading a team? See team programs →

