NClaude Chat - Multi-Session Communication

VerifiedSafe

Send and receive messages between Claude Code sessions using nclaude. Ideal when coordinating multi-agent tasks, sharing progress, or requesting help across parallel sessions. Supports sending, reading (new or all), and status check commands.

Sby Skills Guide Bot
DevelopmentIntermediate
606/2/2026
Claude Code
#multi-agent#collaboration#inter-session#nclaude

Recommended for

Our review

Enables Claude Code sessions to communicate with each other using the nclaude tool for multi-agent task coordination.

Strengths

  • Simplified coordination across multiple Claude sessions
  • Real-time progress updates and information sharing
  • Clear role identification via descriptive session IDs
  • Native integration with Bash and Read tools

Limitations

  • Requires all sessions to run on the same machine or have access to the same nclaude script
  • Messages are not persisted outside the session context
  • No built-in encryption or authentication
When to use it

Use this skill when you decompose a large project into subtasks executed by separate Claude agents and need synchronization.

When not to use it

Avoid using it for simple single-session communications or when message security is critical.

Security analysis

Safe
Quality score95/100

The skill only runs a local Python script for inter-session messaging. There are no destructive commands, network exfiltration, or obfuscation. The script is invoked without piping or shell injection risks. The allowed tools (Bash, Read) are used for legitimate coordination purposes.

No concerns found

Examples

Notify backend session about frontend completion
Send a message to session 'claude-backend' saying 'Frontend login page is ready. Please expose the /api/login endpoint.'
Check for new messages from another session
Read all new messages from session 'claude-frontend' to see if there are updates from the frontend agent.
Announce a blocker to the lead session
Send a message to session 'claude-lead' saying 'Blocked: dependency package X is missing. Can you install it?'

name: nclaude-chat description: Communicate with other Claude Code sessions via nclaude. Use when coordinating multi-agent tasks, sharing progress updates, requesting help from other sessions, or collaborating on parallel work. allowed-tools: Bash, Read

NClaude Chat Skill

Use this skill to send and receive messages between Claude Code sessions.

When to Use

  • Coordinating work across multiple Claude sessions
  • Sharing progress updates with other agents
  • Requesting information or assistance from another session
  • Announcing task completion or blockers

Commands

Send a message

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/nclaude.py send "SESSION_ID" "Your message here"

Read new messages

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/nclaude.py read "SESSION_ID"

Read all messages (including previously read)

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/nclaude.py read "SESSION_ID" --all

Check chat status

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/nclaude.py status

Session ID

Use a descriptive session ID that identifies your role:

  • claude-frontend - Working on frontend code
  • claude-backend - Working on backend/API
  • claude-tests - Running tests
  • claude-review - Code review agent

Or use the NCLAUDE_ID environment variable if set.

Message Format

Messages are logged as: [TIMESTAMP] [SESSION_ID] MESSAGE

Example Workflow

  1. Session A: send "claude-api" "Starting API endpoint implementation for /users"
  2. Session B: read "claude-frontend" to see the message
  3. Session B: send "claude-frontend" "API ready at /api/users, please integrate"
  4. Session A: read "claude-api" to see the reply
Related skills