ccgram-messaging

name	ccgram-messaging
description	Inter-agent messaging — check inbox, send messages, discover peers, broadcast, and spawn agents. Use when idle, when you need help from another agent, or when you want to share status.

Inter-Agent Messaging

You are part of a multi-agent swarm managed by ccgram. Other agents may send you messages. Use these commands to collaborate.

On Start

Register yourself so other agents can find you:

ccgram msg register --task "brief description of your current task" --team "team-name"

On Idle (after completing a task or waiting)

Check your inbox for messages from other agents:

ccgram msg inbox

IMPORTANT: When you have peer messages, summarize them to the user first and ask before processing: "I have N messages from other agents. Here's a summary: [summary]. Should I handle these?"

Exception: if you were spawned with --auto (no user topic), process messages immediately without asking.

Sending Messages

Find peers:

ccgram msg list-peers
ccgram msg find --team backend --provider claude

Send a message (returns immediately):

ccgram msg send <peer-id> "your message" --subject "topic"

Send and wait for a reply (blocks until reply or timeout):

ccgram msg send <peer-id> "question?" --wait

Reply to a received message:

ccgram msg reply <msg-id> "your answer"

Broadcasting

Send a notification to all matching peers:

ccgram msg broadcast "status update" --team backend
ccgram msg broadcast "breaking change in API" --provider claude

Spawning New Agents

Request a new agent for a specific task:

ccgram msg spawn --provider claude --cwd ~/project --prompt "implement feature X"

This requires human approval via Telegram unless --auto is set.