Messaging

Once the broker is up, the CLI can act as a lightweight operator console for human-to-agent messages and recent conversation history.

Send a message

agent-relay send reviewer "Please summarize the riskiest changes first."

The target argument accepts:

• an agent name such as reviewer
• a channel such as #general
• * for broadcast

Optional flags:

• --from <name> changes the sender identity from the default CLI sender.
• --thread <id> keeps follow-ups grouped under an existing thread.

Read recent history

agent-relay history --to '#general' --since 30m

Useful filters:

• --from <agent> keeps only one sender.
• --to <agent-or-channel> narrows to a target or channel.
• --since <time> accepts values like 30m, 1h, or an ISO date.
• --json emits structured output for scripts.

Check the inbox

agent-relay inbox

inbox summarizes unread channels, mentions, and DMs. Add --json if another tool will parse the result.

Practical pattern

agent-relay send planner "Create the plan, then hand implementation to coder."
agent-relay history --from planner --since 15m
agent-relay inbox

See also