CLI REFERENCE
One entrypoint, with shipped and designed verbs separated.
virgo is the only user-facing entrypoint. This reference labels what the audited release executes today and what remains an approved design surface.
BOOTSTRAP
From host to first resident persona.
virgo onboardMeasure and prepare a first hub machine or join an existing hub.virgo initCreate owner canon and the immutable home workspace ID.virgo workspace add NAMECreate an isolated work domain.virgo workspace listInspect registered work domains.AVAILABLE · PERSONAS
Register, inspect, and retire identity.
virgo persona add [name]Register scope/project/role path and character profile.virgo persona listRead persona and duty bindings.virgo persona retire <name-or-address>Stop placement and new delivery without deleting lineage.AVAILABLE · HUB
Operate the first pinned store runtime.
virgo hub startStart or exactly resume the configured FalkorDB/Redis container.virgo hub statusRead health and release/config specification match.virgo hub stopStop idempotently while preserving container and data.SKILLS
Personal edits are local. Shared revisions are receipt-bound.
virgo skill listFilter persona, class, and workspace skills.virgo skill add / editActivate personal skills in-scope; create proposed revisions for shared behavior.virgo skill approveroot/operator activates the exact proposed hash with an owner-private HMAC-signed receipt; active reads revalidate it.DESIGNED · NOT YET EXECUTABLE IN THE PINNED RELEASE
Lifecycle, diagnostics, whole-system status, and operator receipts.
virgo persona up / down / statusApproved lifecycle/status surface; current executable does not expose these verbs yet.virgo channel doctor [<binding>]Designed single-flight, privacy-preserving channel diagnostic and receipt.virgo statusDesigned whole-system view of machines, personas, fences, and queues.virgo operator verify-contextDesigned execution-context attestation receipt.virgo operator promote-completionDesigned receipt-bearing completion promotion.DIAGNOSE