Coordinate multi-agent file access via aq (ambient queue). Use before modifying shared files in parallel agent sessions to announce claims and check for conflicts. Gossip, not locks.
Wraps the aq CLI tool for gossip-based multi-agent coordination.
Broadcasts are ephemeral (they expire). Silence is normal. This is
advisory, not mandatory — no operation blocks.
aq check -f "file1.py,file2.py" --json
If another agent has announced these files, report the conflict to the user and ask whether to proceed.
For substantive work (high priority, 5-minute TTL):
aq announce -c "<conjecture-or-task-id>" -f "file1.py,file2.py"
For lightweight/read-only work (low priority, 1-minute TTL):
aq whisper -c "<task-id>" -f "file1.py"
aq status --json
aq prime
aq check returns conflicts: warn the user, do NOT silently
proceed. Let the user decide.aq is not installed or ~/.aq doesn't exist: skip silently.
This tool is advisory. Never fail a task because aq is unavailable.announce for file writes, whisper for file reads or docs.aq init
Creates ~/.aq directory structure. Run once per machine.