Queen command reference
Queen's command shapes and control-plane surfaces. Queen is in active design; the exact command names are pinned as the first releases land. The shapes below are decided. Grounded in the Queen technical manual.
Queen command reference
Queen's command shapes and control-plane surfaces. Queen is in active design; the exact command names are pinned as the first releases land. The shapes below are decided. Grounded in the Queen technical manual.
Related:
#Local agent commands
| Command | Purpose |
|---|---|
queen pair |
Bind this machine to a cloud deployment. Required before anything else works. |
queen status |
Print this machine's binding, identity, and presence state. The local view, in place of a dashboard. |
queen enroll --token <token> |
Redeem a short-lived join token on a new machine for a per-agent credential. |
queen enroll-token create |
On an already-trusted machine, mint a short-lived join token for another machine. |
#Control-plane API
Every route is org-scoped, and tenancy is enforced on every request.
| Area | What it does |
|---|---|
| Binding and licensing | Present the binding credential and heartbeat the license. |
| Presence and fleet roster | Upsert the last-seen heartbeat with an optional status change, and read the fleet roster with derived health. |
| Enrollment and identity | Mint a join token, redeem a token for a per-agent credential, and let a trusted host vouch for its sub-agents. |
| Signed commands | Request a signed command, poll the command channel, and acknowledge. |
| Aggregation read | Roll up ROI by org, team, user, project, and time, carrying the cost basis through. |
#Dashboards
Served by the cloud application, behind sign-in: a read-only fleet dashboard, and a separate authenticated ROI admin surface.
#Package
The local agent is packaged as @legioncodeinc/queen. It opens no human-facing HTTP listener.