> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quanux.org/symphony/llms.txt
> Use this file to discover all available pages before exploring further.

# qxctl: la riga di comando amministrativa agentica di Symphony

> qxctl è la CLI amministrativa in Go di Symphony. Scopri i suoi 373 comandi eseguibili, il registro dei binding degli engine v2 e il modello di invocazione sicura per gli engine.

`qxctl` è la CLI amministrativa e di interrogazione di Symphony, scritta in Go e pensata innanzitutto per gli agenti. Parla il linguaggio dei comandi; i vettori di dominio sono proprietari delle operazioni e dei significati sottostanti. Il suo registro versionato associa ogni foglia di comando eseguibile a un'identità macchina stabile e a evidenze revisionate di amministrazione delle funzionalità.

## Cosa copre qxctl

qxctl implementa l'amministrazione per:

* Ispezione di repository e contratti
* Amministrazione di validatore, avvisi, invarianti, funzionalità, ciclo di vita, sessioni, riconciliazione, binding e Maestro
* Amministrazione dell'identità SSIAG, dell'audit STAV e dei producer Accordare
* Grammatica degli engine vettoriali implementati (`skvi`, `sclv`, `sacv`, `sodv`, `ssfv`, oltre alle superfici SCV e SHV)

Il registro attuale contiene **373** comandi eseguibili.

## Modello di invocazione sicura

qxctl invoca installazioni esatte validate tramite ricevute usando sottoprocessi delimitati, scadenze rigide, controlli di identità e digest delle risposte, transazioni sullo stato atteso e recupero durevole. Non accetta mai percorsi di adattatori o versioni grezze al posto delle ricevute.

## Registro dei binding degli engine v2

Il registro dei binding degli engine v2 supporta gli otto ruoli di engine consolidati e identità di ruolo future delimitate. Lo stato legacy v1 è in doppia lettura; la migrazione a v2 richiede un compare-and-swap esplicito vincolato al digest tramite qxctl e non è mai un'operazione di selezione della versione.

## Comandi del registro

Genera e verifica il registro atteso da `tools/qxctl`:

```bash Registry generation and verification theme={null}
go run ./cmd/qxctl commands expected --json > COMMANDS.json
go run ./cmd/qxctl commands verify --input COMMANDS.json --json
```

Un client installato può emettere evidenze vincolate all'eseguibile:

```bash Manifest from installed qxctl theme={null}
qxctl commands manifest --json
```

Le evidenze attese hanno versione del client, digest dell'eseguibile e digest della ricevuta nulli. Le evidenze osservate vincolano la versione esatta del client e il digest dell'eseguibile, oltre a un digest della ricevuta quando disponibile. Entrambe le forme usano `symphony.qxctl.command-registry.v1`.

> [!NOTE]
>
> qxctl è proprietario della grammatica e della presentazione dei comandi. Non è proprietario della semantica dei vettori né della verità canonica della conoscenza. Solo modifiche revisionate al codice sorgente ratificano una nuova identità `qxcmd`, indipendentemente dalla classe del chiamante.

## Gruppi di comandi

> [card] [knowledge](https://docs.quanux.org/symphony/it/qxctl/knowledge.md)
>
> Ciclo di vita tra vettori e amministrazione persistente delle sessioni SSFV.

> [card] [lifecycle](https://docs.quanux.org/symphony/it/qxctl/lifecycle.md)
>
> Profilo, ownership, observe, report, boot, apply e recupero.

> [card] [engines](https://docs.quanux.org/symphony/it/qxctl/engines.md)
>
> Registro dei binding degli engine e migrazione.

> [card] [reconcile](https://docs.quanux.org/symphony/it/qxctl/reconcile.md)
>
> Riconciliazione dei worktree del coordinatore.

> [card] [session](https://docs.quanux.org/symphony/it/qxctl/session.md)
>
> Sessioni autenticate e flussi di manutenzione SSFV.

> [card] [maestro](https://docs.quanux.org/symphony/it/qxctl/maestro.md)
>
> Inventario derivato dei recettori ed evidenze di aggancio.

> [card] [validate](https://docs.quanux.org/symphony/it/qxctl/validate.md)
>
> Policy protetta degli avvisi e amministrazione del validatore.

> [card] [comandi dei vettori](https://docs.quanux.org/symphony/it/qxctl/vector-commands.md)
>
> `skvi`, `sclv`, `sacv`, `sodv`, `ssfv`, `shv` e la futura grammatica accord/evolution.


## Related topics

- [Documentazione di QuanuX Symphony](https://docs.quanux.org/symphony/it/index.md)
- [Guida rapida: esplora QuanuX Symphony](https://docs.quanux.org/symphony/it/quickstart.md)
- [Symphony Ops Vector: controllo delle operazioni con qxctl](https://docs.quanux.org/symphony/it/vectors/sov.md)
- [Symphony Intelligence Vector: la futura collaborazione tra agenti](https://docs.quanux.org/symphony/it/vectors/siv.md)
- [Architettura di Symphony](https://docs.quanux.org/symphony/it/concepts/architecture.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.