channels-event-streaming

name	channels-event-streaming
description	Claude Code Channels: real-time event streaming between concurrent sessions, pub/sub patterns, event filtering, cross-session state synchronization, and reactive agent workflows

Channels — Real-Time Event Streaming

When to activate

• Running multiple Claude Code sessions that need to share state or coordinate work
• Building reactive workflows that respond to events (file changes, CI results, deployment status)
• Implementing pub/sub patterns where one session publishes events and others subscribe
• Streaming progress updates from a long-running background session to the main session
• Coordinating multi-agent workflows where agents need real-time awareness of each other's progress
• Building event-driven development loops (code → test → deploy → monitor → react)

When NOT to use

• Single-session workflows with no cross-session communication needs
• One-shot tasks that don't benefit from event-driven architecture
• Simple file-based state passing (just read/write a shared file)
• When eventual consistency is fine and polling works just as well

Instructions

1. Channel Architecture

Channels provide real-time event streams between Claude Code sessions:

┌──────────────┐  publish   ┌──────────┐  subscribe  ┌──────────────┐
│  Session A   │──────────▶│  Channel │◀────────────│  Session B   │
│  (publisher) │            │  (stream)│             │  (subscriber)│
└──────────────┘            └──────────┘             └──────────────┘
                                  │
                            subscribe
                                  │
                            ┌──────────────┐
                            │  Session C   │
                            │  (subscriber)│
                            └──────────────┘

2. Channel Types