Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.yourhq.ai/llms.txt

Use this file to discover all available pages before exploring further.

Commands are rows in agent_commands. They represent every instruction the UI gives to a gateway — provisioning agents, approving pairings, connecting providers, restarting services, and more.

​
State machine

pending  →  leased  →  running  →  done
                    ↘          ↘  failed
1

UI inserts a command

A server action writes a row to agent_commands with status = 'pending'.
2

Runner leases the command

The runner daemon picks it up via Realtime subscription or polling, then calls lease_command(p_gateway_slug) to atomically claim it.
3

Runner executes

The runner maps the command action to a shell operation (e.g. add-agent.sh for provision) and runs it.
4

Runner reports results

On completion, the runner writes stdout, stderr, exit_code, and final status (done or failed) back to the row.

​
Durability

Commands are never deleted after completion. They persist as a full history of every operation — viewable from Settings → System → Commands.
If a command is stuck in leased or running for more than 5 minutes, the runner likely crashed or lost its lease. Check docker compose logs runner for details.