Skip to main content
qxctl is Symphony’s Go-based, agentic-first administrative and query CLI. It speaks commands; domain vectors own the operations and meanings behind them. Its checked-in registry binds every executable command leaf to a stable machine identity and reviewed feature-administration evidence.

​
What qxctl covers

qxctl implements administration for:
  • Repository and contract inspection
  • Validator, warning, invariant, feature, lifecycle, session, reconciliation, binding, and Maestro administration
  • SSIAG identity, STAV audit, and Accordare producer administration
  • Implemented vector-engine grammar (skvi, sclv, sacv, sodv, ssfv, plus SCV and SHV surfaces)
The current registry contains 373 executable commands.

​
Safe invocation model

qxctl invokes exact receipt-validated installations using bounded subprocesses, hard deadlines, response identity and digest checks, expected-state transactions, and durable recovery. It never accepts adapter paths or raw versions in place of receipts.

​
Engine-binding registry v2

The engine-binding registry v2 supports the eight established engine roles and bounded future role identities. Legacy v1 state is dual-read; migration to v2 requires an explicit digest-bound compare-and-swap through qxctl and is never a version-selection operation.

​
Registry commands

Generate and verify the expected registry from tools/qxctl:
Registry generation and verification
An installed client can emit executable-bound evidence:
Manifest from installed qxctl
Expected evidence has null client version, executable digest, and receipt digest. Observed evidence binds the exact client version and executable digest, plus a receipt digest when one is available. Both forms use symphony.qxctl.command-registry.v1.
qxctl owns command grammar and presentation. It does not own vector semantics or canonical knowledge truth. Only reviewed source changes ratify a new qxcmd identity, regardless of caller class.

​
Command groups

knowledge

Cross-vector lifecycle and persistent SSFV-session administration.

lifecycle

Profile, ownership, observe, report, boot, apply, and recovery.

engines

Engine binding registry and migration.

reconcile

Coordinator worktree reconciliation.

session

Authenticated sessions and SSFV maintenance streams.

maestro

Derived receptor inventory and docking evidence.

validate

Protected warning policy and validator administration.

vector commands

skvi, sclv, sacv, sodv, ssfv, shv, and future accord/evolution grammar.
Last modified on September 24, 2026