mem:inbox
mem:inbox
Section titled “mem:inbox”Check coordination signals
Options:
| Flag | Description | Required |
|---|---|---|
--wu <wuId> | Work Unit ID to link | No |
-l, --lane <lane> | Lane name (e.g., “Operations: Tooling”) | No |
-s, --since <time> | Filter signals since time (e.g., “1h”, “30m”, “2025-12-09”); with —watch it bounds both the initial drain and every later change | No |
-w, --watch | Continuously monitor for new signals: shows every matching signal this watcher has not yet displayed (selection is by signal id, never by arrival time), including one already marked read by a push-delivery receipt; add —unread-only to skip read signals | No |
--unread-only | With —watch, show only signals still unread for the reader (a signal marked read by a push-delivery receipt is skipped); without —watch unread-only is already the default | No |
-q, --quiet | Suppress output except signal content | No |
--ack | Acknowledge displayed signals for the resolved reader | No |
--no-mark | Deprecated no-op; reads are non-destructive by default | No |
-c, --count | Output only signal count (lightweight polling for orchestrators) | No |
--for <session_id|display_name|agent_identity> | Show signals addressed to a session or agent identity, plus broadcasts | No |
--thread <id> | Show signals in a single A2A thread | No |
--intent <intent[,intent...]> | Filter by A2A intent values (INFO, PROPOSE, COUNTER, AGREE, REJECT) | No |
--target-role <descriptor> | Show only signals stamped with exactly this intended-recipient role descriptor (exact, case-sensitive match, no hierarchy: orchestrator/prime does not match orchestrator); with —pending-ack, answer for this role instead of the roles in the reader session record | No |
--initiative <id> | Show only signals scoped to this initiative | No |
--pending-ack | View only signals still awaiting an ACK/REJECT that are addressed to the reader by session identity (—for) or, when the signal names no recipient, by role; the two are a union; unaddressed broadcasts are excluded; not combinable with —watch. Only an addressee can resolve a directed signal (an AGREE/REJECT from any other session is visible as activity but never clears it); a role-only broadcast is resolved by any reply, since answering it is delegated role authority | No |
--include-self | Diagnostic: include the current session’s own outbound signals in —watch output (suppressed by default to avoid self-echo) | No |