opschain admin agent
packs:agents
Operate one agent. Every subcommand takes the agent's member id — the ID
column of opschain admin agents list — and talks to the admin-gated
v2 AgentService procedures (the REST /api/agents/{id} routes stay mounted for the GUI and the static-token lane). The lifecycle verbs grade in severity: a
drain quiesces the agent's capabilities (reversible with resume), a
halt is the break-glass hard stop (channel severed, every credential
refused; reversible with halt-resume), a revoke tombstones the
agent's key permanently, and a forget merely removes a stale
registration so the identity may re-register.
| Subcommand | Purpose |
|---|---|
show | One agent in full: identity, manifest, lifecycle, channel and host inventory — opschain docs cli/admin-agent-show. |
drain | Quiesce the agent: only its minimum-spec surfaces keep answering — opschain docs cli/admin-agent-drain. |
resume | Lift the drain — opschain docs cli/admin-agent-resume. |
halt | Emergency halt, break-glass audited — opschain docs cli/admin-agent-halt. |
halt-resume | Lift the emergency halt — opschain docs cli/admin-agent-halt-resume. |
forget | Remove a stale registration (refused while online) — opschain docs cli/admin-agent-forget. |
revoke | Tombstone the key and sever channel and sessions — opschain docs cli/admin-agent-revoke. |
activity | The agent's audit timeline — opschain docs cli/admin-agent-activity. |
trust-review | The agent's governance posture and track record — opschain docs cli/admin-agent-trust-review. |
assignments | The agent's assets-under-management assignments — opschain docs cli/admin-agent-assignments. |
owner | Set or clear the agent's owning user or group (accountability, never privilege) — opschain docs cli/admin-agent-owner. |
instances | The agent's instances — its running processes — grouped by release and lane — opschain docs cli/admin-agent-instances. |
rollover | Move one lane of the agent to another release (replace, canary=<n> or blue-green), with continue / abort / rollback / finish / show beneath it — opschain docs cli/admin-agent-rollover. |
See also
opschain docs cli/admin-agents-list— the fleet view (and the source of agent ids).opschain docs cli/admin-trust— trust grants and assignments.