Documentation Index
Fetch the complete documentation index at: https://docs.codewire.sh/llms.txt
Use this file to discover all available pages before exploring further.
Messaging
Named agents exchange structured messages — direct messages for fire-and-forget, request/reply for synchronous coordination.
msg
Send a direct message to a session. Target can be a session ID or name.
cw msg <target> <body> [-f <session>]
| Flag | Description |
|---|
target | Session ID or name to send to |
body | Message content |
-f | Sender session (for named agent identity) |
# Run named agents
cw run planner -- claude -p "plan the refactor"
cw run coder -- claude -p "implement changes"
# Send a direct message
cw msg -f planner coder "start with the auth module"
inbox
Read messages from a session’s inbox. Shows direct messages and pending requests.
cw inbox <session> [-t <N>]
| Flag | Description |
|---|
session | Session ID or name |
-t | Show last N messages |
request
Send a request and block until a reply arrives. Synchronous coordination between agents.
cw request <target> <body> [-f <session>] [--timeout <s>]
| Flag | Description |
|---|
target | Session ID or name |
body | Request content |
-f | Sender session |
--timeout | Maximum wait time in seconds |
cw request -f planner coder "ready for review?"
# [reply from coder] yes, PR #42 is up
reply
Reply to a pending request. Request ID comes from cw inbox or message.request events.
cw reply <request-id> <body> [-f <session>]
listen
Stream all message traffic in real-time. Shows messages, requests, and replies as they happen.
cw listen [--session <session>]
Example: Coordinated Agents
# Run named agents
cw run planner -- claude -p "plan the refactor"
cw run coder -- claude -p "implement changes"
# Planner sends instructions
cw msg -f planner coder "start with the auth module"
# Planner asks for status (blocks until reply)
cw request -f planner coder "ready for review?"
# Monitor all message traffic
cw listen
