Skip to content

mem:signal

← Back to CLI Commands

Broadcast coordination signal

pnpm mem:signal

Options:

FlagDescriptionRequired
-m, --message <text>Signal message (required if not positional)No
--wu <wuId>Work Unit ID to link (e.g., WU-123)No
-l, --lane <lane>Lane name (e.g., “Operations: Tooling”)No
-q, --quietSuppress output except errors (outputs signal ID only)No
--role <descriptor>Sender role descriptor (e.g. “implementer/general”)No
--target-role &lt;descriptor&gt;Intended-recipient role descriptor; read it with mem:inbox —target-role <descriptor>, and mem:inbox —pending-ack resolves it against the reader roleNo
--initiative &lt;id&gt;Initiative scope (e.g., INIT-001); valid on its own without —wu or —laneNo
--delegation-id &lt;id&gt;Delegation registry linkage (dlg-XXXX)No
--to &lt;recipient[,recipient...]&gt;Address the signal: a session ID, display name, or agent identity for local delivery, or agent:<workspace>:<identity> | repo:<workspace> | project:<target_workspace> for cross-workspace delivery (single target only)No
--thread &lt;id&gt;A2A thread id for grouping signalsNo
--reply-to &lt;signal_id&gt;Parent signal id; inherits the parent thread when —thread is omittedNo
--intent &lt;INFO|PROPOSE|COUNTER|AGREE|REJECT&gt;Machine-readable A2A signal intentNo
--interrupt-class &lt;advisory|priority|urgent|soon|immediate&gt;A2A interrupt class (advisory|priority|urgent canonical; soon|immediate are legacy aliases)No
--interrupt &lt;advisory|priority|urgent|soon|immediate&gt;[DEPRECATED] Legacy alias for —interrupt-class. Same enum values.No
--requires-ackMark the signal as requiring an AGREE or REJECT replyNo
--authenticateMint an authenticated directive receipt, one independent single-use receipt per —to recipient (requires —wu, —to, —directive-class, the canonical body, and a host-bound caller proof)No
--directive-class &lt;wake|pause|resume|redirect|advisory&gt;Closed directive action for —authenticate; arbitrary action prose is never authenticatedNo
--expires-in-minutes &lt;n&gt;TTL for an authenticated directive receipt (default 30, clamped 1-240)No
--verify-directive &lt;signal_id&gt;Verify and consume this reader’s own directive receipt with the current host-bound caller proof; fails closed for legacy sessionsNo

← Back to CLI Commands