aq — Ambient Agent Queue

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.

When to use

Before editing shared files in a multi-agent session: check for conflicts, then announce your claim
After completing work on claimed files: let the broadcast expire naturally (TTL-based) or announce completion
When spawning parallel agents: each agent should announce its file set to reduce merge conflicts

Core workflow

1. Check before editing

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.

aq — Ambient Agent Queue

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.

When to use

Before editing shared files in a multi-agent session: check for conflicts, then announce your claim
After completing work on claimed files: let the broadcast expire naturally (TTL-based) or announce completion
When spawning parallel agents: each agent should announce its file set to reduce merge conflicts

Core workflow

1. Check before editing

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.

Aq

aq — Ambient Agent Queue

When to use

Core workflow

1. Check before editing

Aq

aq — Ambient Agent Queue

When to use

Core workflow

1. Check before editing

2. Announce your claim

3. Check current broadcasts

Agent bootstrap context

Decision rules

Initialization

Mcporter

Sonoscli

Openhue

Healthcheck

Things Mac

Eightctl