Messaging & store
Inter-agent messaging and the document store commands.
Messaging
See Inter-Agent Messaging for details.
gr msg pub <body>
Publish to a stream.
| Flag | Description |
|---|---|
-t, --topic <name> | Stream/topic name (required) |
-f, --file <path> | Read body from file |
--thread <id> | Thread ID to continue |
--reply-to <stream> | Stream for replies |
--no-reply | Declare that no reply is expected |
gr msg send <session> [body]
Send a message to a session’s inbox; also types a PTY notification by default.
| Flag | Description |
|---|---|
-f, --file <path> | Read body from file |
--thread <id> | Thread ID to continue |
--reply-to <stream> | Stream for replies |
--no-reply | Declare that no reply is expected |
-q, --quiet | Don’t type a notification into the session |
--children | Send to all descendant sessions |
--parent | Send to the parent session |
gr msg sub
Read from a stream.
| Flag | Description |
|---|---|
-t, --topic <name> | Stream/topic name (required) |
-w, --wait | Block until a message arrives |
-F, --follow | Stream continuously |
--ack | Acknowledge after reading |
-a, --all | Show all messages, not just unread |
--thread <id> | Filter to a specific thread |
gr msg ack
Acknowledge all messages in a stream.
| Flag | Description |
|---|---|
-t, --topic <name> | Stream/topic name (required) |
gr msg topics
List streams with total and unread message counts.
| Flag | Description |
|---|---|
--system | Include _system.* streams |
gr msg jail list
List PR comments quarantined by the author-trust gate (see Comment author-trust gate).
| Flag | Description |
|---|---|
--released | Include already-released comments |
gr msg jail show <id>
Show a single quarantined comment, including its body.
gr msg jail release [id]
Release a quarantined comment — deliver it to the target session’s inbox. User or orchestrator only; plain agent sessions are rejected.
| Flag | Description |
|---|---|
--all | Release all jailed comments from an author (requires --author) |
--author <login> | Author login to release (with --all) |
Document store
See Document Store for details.
gr store put <key> [body]
Store a document. Reads stdin if no body or --file.
| Flag | Description |
|---|---|
-f, --file <path> | Read body from file |
gr store get <key>
Retrieve a document’s raw body.
gr store list [prefix] (alias: ls)
List documents, optionally filtered by key prefix.
| Flag | Description |
|---|---|
-a, --all | List across all repos |
gr store append <key> [line]
Append a line to a document, creating it if absent. Reads stdin if no body or --file.
| Flag | Description |
|---|---|
-f, --file <path> | Read line from file |
gr store rm <key>
Remove a document.
Store persistent flags
All store subcommands accept:
| Flag | Description |
|---|---|
--repo <path> | Repo path (default: auto-detect) |
--shared | Use the global store (not scoped to any repo) |