← ClaudeAtlas

aq-commslisted

Messages, inbox, and human questions in the aq daemon. Use to check for queued messages (`aq message inbox`), send a message to the user or another agent (`aq message send`), reply to a specific message (`aq message reply`), or report a blocking question with `aq message send`. Also covers the message-delivery model (session vs user vs task recipients).
ElectricJack/agent-queue · ★ 8 · AI & Automation · score 74
Install: claude install-skill ElectricJack/agent-queue
# aq comms — Messaging and asking humans The daemon's message bus carries three kinds of frames: agent → user ("I need X"), user → agent (chat + directives), and agent → agent (coordination). All flow through `aq message`. ## Read ```bash aq message inbox # your session's pending messages aq message inbox --json # structured (--json is # global: any position works) aq message list --project <pid> # everything sent in a project aq message list --thread-id dashboard:<pid> # filter to a chat thread aq message status <message-id> --json # one message you were handed, # body included ``` Every session that starts with a bearer token gets an automatic inbox. Nothing renders it at every prompt boundary: the `UserPromptSubmit` hook that ran `aq inbox --inject` was removed on 2026-08-27. Pending messages reach you when `aq prime` runs (start, resume, post-compact) and through the cascade's nudge, which types a one-line pointer into the session once it goes idle: ``Handle `aq message status <id> --json`.`` Run that command to read the body. The nudge has already marked the message delivered, so `aq message inbox` no longer lists it. A plain session may read the status only of messages addressed to its own session, held task or profile; anything else answers "not found". (A task comment is the exception: its body is ty