---
title: "Claude Code Cross-Session Messaging Explained"
url: https://aideveloper44.com/blog/claude-code-cross-session-messaging-technical-overview
description: "Technical overview of Claude Code's cross-session messaging feature. Learn how AI agents coordinate tasks, share status, and manage permissions across terminals."
lang: en
---

Agents (https://aideveloper44.com/blog/tag/agents)

# Claude Code Introduces Cross-Session Messaging for Agent Coordination

Anthropic has released cross-session messaging for Claude Code, allowing independent AI sessions to communicate and coordinate tasks across terminals.

A

AIDeveloper44 Team

August 8, 2026 · 5 min read

Image: Claude Code Introduces Cross-Session Messaging for Agent Coordination (https://media.base44.com/images/public/696b2bd107af20deac4cc200/8cd724c3a_generated_image.png)

Claude Code's cross-session messaging enables independent AI instances to synchronize work through a secure communication layer.

TL;DR

- Cross-session messaging enables Claude Code sessions to exchange technical summaries and status updates.
- The feature requires Claude Code version 2.1.224 or later and is available on macOS and Linux systems.
- Security is managed through per-session permission boundaries and configurable inbound message controls.

## Technical Coordination Between Independent Sessions

Anthropic has implemented a cross-session messaging feature within Claude Code (https://code.claude.com/docs/en/cross-session-messaging), designed to facilitate communication between separate agent instances running on the same machine or across different devices. This capability allows one Claude session to deliver specific text-based information to another session without the user manually copying data between terminal windows. This system is particularly relevant for developers managing complex workflows where multiple agents are assigned to different parts of a codebase or different worktrees.

The feature is restricted to text communication; it does not transfer entire conversation histories or file contents. Instead, it serves as a notification and synchronization layer. According to the official documentation, the system is automatically active for users running Claude Code version 2.1.224 or higher on supported Unix-based operating systems, specifically macOS and Linux.

## Functional Use Cases for Developer Workflows

Cross-session messaging addresses several common scenarios in parallel development. One primary application is the handover of findings. When one agent session identifies a breaking change or reaches a significant architectural decision, it can summarize these findings for another session currently active in the affected area of the project. This reduces the need for the human developer to act as a manual relay for technical context.

The system also assists in coordinating work across parallel worktrees. In environments where multiple sessions are operating on the same repository via separate worktrees, Claude can inform other sessions about which changes have been committed or landed. Additionally, developers can use the feature to monitor long-running tasks. For example, a session managing a database migration or an extensive test suite can report its completion or status back to the primary session the developer is actively monitoring.

For remote work, cross-session messaging supports replies across machines or through the web via Remote Control. In these cross-machine scenarios, however, there is a functional limitation: the remote agent can only reply to incoming messages and cannot initiate a new exchange with a session on a different machine.

### The Toolset: ListAgents and SendMessage

Claude manages these interactions through two specific internal tools: `ListAgents` and `SendMessage`. The `ListAgents` tool is used for discovery, allowing the agent to identify which other sessions are currently reachable and what names they answer to. Users can also manually view these sessions by executing the `/list-agents` command in the terminal.

The `SendMessage` tool handles the actual delivery of text. While Claude can decide to send a message autonomously when it detects a dependency or a conflict, users can also explicitly prompt the agent to communicate. Examples of such prompts include asking a session to check if a migration is finished or requesting that one session explain a specific set of changes to another session working on a different API component.

## Message Delivery and Inbound Controls

Message delivery is timed to ensure it does not interrupt active tool execution. The receiving Claude instance reads incoming messages between tool calls during an active turn. If the receiving session is currently idle, the arrival of a message triggers a new turn automatically. The delivery process is governed by a set of inbound controls that result in one of three states:

- **Delivered:** The message is successfully passed to the receiving Claude agent.
- **Held:** The message is set aside and only reaches the agent if the user provides manual approval or if settings are modified to allow it.
- **Refused:** The system drops the message entirely based on pre-defined security or configuration rules.

Crucially, permission boundaries remain isolated to each individual session. An agent is instructed not to request actions from another session that would violate its own permission settings. Furthermore, any action requested via a message is still subject to the receiving session's specific rules and manual approval prompts.

## Availability and Configuration Requirements

To utilize cross-session messaging, users must be on a compatible version of the tool. The feature is supported for various LLM providers, though users are encouraged to check the specific `Availability` section of the documentation to confirm their provider's compatibility. Configuration options allow users to restrict messaging, require manual approval for any messages originating from other machines, or disable the feature entirely if a strictly isolated environment is required.

It is important to distinguish this feature from other parallel work capabilities in Claude Code. While cross-session messaging is for independent, user-steered sessions, other features such as 'agent teams' are designed for sessions that Claude spawns and supervises directly. Similarly, 'Remote Control' is intended for direct human steering of a session from a different device, rather than agent-to-agent communication.

References & Sources

1. Message your other Claude Code sessions - Claude Code Docs: https://code.claude.com/docs/en/cross-session-messaging

Read more: https://x.com/ClaudeDevs/status/2085817074816070014

Claude Code: https://aideveloper44.com/blog/tag/claude-code
Anthropic: https://aideveloper44.com/blog/tag/anthropic
AI Agents: https://aideveloper44.com/blog/tag/ai-agents
Developer Tools: https://aideveloper44.com/blog/tag/developer-tools
Automation: https://aideveloper44.com/blog/tag/automation

### Enjoyed this?

Get more posts like this delivered to your inbox.

← Previous

Amazon RDS for MariaDB Adds Support for MariaDB Version 12.3
https://aideveloper44.com/blog/amazon-rds-mariadb-12-3-support

Next →

Anthropic Sets Auto Mode as Default for Claude Code
https://aideveloper44.com/blog/anthropic-claude-code-auto-mode-default

## Related Articles

Tools

### Anthropic Introduces MCP Tasks and Elicitations for Claude Code

3 min read
https://aideveloper44.com/blog/anthropic-introduces-mcp-tasks-and-elicitations

Tools

### Google Releases Gemini API CLI: An Experimental Terminal Tool Bringing Google's Latest Reasoning Models, Media Generation, Multimodal Analysis, and Managed Agents Into AI Coding Agents You Already Use

3 min read
https://aideveloper44.com/blog/google-releases-experimental-gemini-api-cli

Announcements

### Anthropic Updates Claude Security with Continuous Monitoring

4 min read
https://aideveloper44.com/blog/claude-security-updates-continuous-monitoring

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "@type": [
      "WebSite",
      "NewsArticle"
    ],
    "name": "AIDeveloper44",
    "url": "https://aideveloper44.com",
    "isAccessibleForFree": true,
    "isPartOf": {
      "productID": "CAowsfXgCw:openaccess",
      "@type": [
        "Product"
      ]
    }
  },
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    "name": "AIDeveloper44",
    "url": "https://aideveloper44.com",
    "logo": "https://qtrypzzcjebvfcihiynt.supabase.co/storage/v1/object/public/base44-prod/public/696b2bd107af20deac4cc200/9f77c0b91_a-digital-illustration-of-a-white-llama-_j4dyH5xoRnKf_3rtw-mvEQ_OdqL2BrSTtKHjJAuhTp_zg.png"
  },
  {
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "Home",
        "item": "https://aideveloper44.com/"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "Blog / Blog Index",
        "item": "https://aideveloper44.com/blog"
      },
      {
        "@type": "ListItem",
        "position": 3,
        "name": "Blog Article",
        "item": "https://aideveloper44.com/blog/claude-code-cross-session-messaging-technical-overview"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    "name": "AINews.sh",
    "alternateName": "AI News",
    "url": "https://ai-dev-pulse-ac4cc200.base44.app",
    "logo": "https://ai-dev-pulse-ac4cc200.base44.app/logo.png",
    "description": "Developer-focused AI product releases, reviews, and news. Your source for the latest AI tools, open-source models, and platform updates.",
    "foundingDate": "2026",
    "slogan": "Stay ahead with AI product intelligence",
    "sameAs": [],
    "knowsAbout": [
      "Artificial Intelligence",
      "Machine Learning",
      "Large Language Models",
      "AI Tools",
      "Open Source AI",
      "AI Frameworks",
      "Developer Tools"
    ]
  },
  {
    "@context": "https://schema.org",
    "@type": "NewsArticle",
    "headline": "Claude Code Introduces Cross-Session Messaging for Agent Coordination",
    "description": "Anthropic has released cross-session messaging for Claude Code, allowing independent AI sessions to communicate and coordinate tasks across terminals.",
    "image": "https://media.base44.com/images/public/696b2bd107af20deac4cc200/8cd724c3a_generated_image.png",
    "datePublished": "2026-08-08T21:36:02.556Z",
    "dateModified": "2026-08-08T21:35:59.089000",
    "author": {
      "@type": "Person",
      "name": "AIDeveloper44 Team"
    },
    "publisher": {
      "@type": "Organization",
      "name": "AIDeveloper44"
    },
    "mainEntityOfPage": {
      "@type": "WebPage",
      "@id": "https://aideveloper44.com/blog/claude-code-cross-session-messaging-technical-overview"
    },
    "isAccessibleForFree": true
  }
]
```