amq-cli

# AMQ CLI Skill File-based message queue for agent-to-agent coordination. AMQ manages the conversation, not the task plan. Use it for messaging, routing, replies, and adapter-emitted lifecycle events; keep work decomposition and execution in the orchestrator above it. ## Prerequisites Requires `amq` binary in PATH. Install: ```bash curl -fsSL https://raw.githubusercontent.com/avivsinai/agent-message-queue/main/scripts/install.sh | bash ``` ## Environment Rules AMQ primarily uses `AM_ROOT` (which mailbox tree) and `AM_ME` (which agent). Pinned terminals also carry `AM_BASE_ROOT` plus an independent `AM_SESSION` identity; sessionless pins use the exact root as `AM_BASE_ROOT` and an empty `AM_SESSION`. Getting these wrong means messages go to the wrong place or silently disappear, so let the CLI handle them rather than guessing. **Inside `coop exec`** — everything is pre-configured. Just run bare commands: ```bash amq send --to codex --body "hello" # correct amq send --me claude --to codex ... # wrong — --me overrides the env ./amq send ... # wrong — use amq from PATH ``` The reason: `coop exec` sets `AM_ROOT`, `AM_ME`, `AM_BASE_ROOT`, and `AM_SESSION` precisely for the session. Passing `--me` overrides the identity; for read-side sibling access, use `--session <name>` instead of overriding the raw root. **Outside `coop exec`** — resolve the root from config, don't hardcode it: ```bash eval "$(amq env --me claude)" # reads .amqrc c...