> ## 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: linha de comandos administrativa agêntica do Symphony

> O qxctl é a CLI administrativa em Go do Symphony. Conheça os seus 373 comandos executáveis, o registo de associações de engines v2 e o modelo de invocação segura para engines.

O `qxctl` é a CLI administrativa e de consulta do Symphony, escrita em Go e pensada primeiro para agentes. Fala em comandos; os vetores de domínio são responsáveis pelas operações e pelos significados por detrás deles. O seu registo versionado no repositório associa cada folha de comando executável a uma identidade de máquina estável e a evidência revista de administração de funcionalidades.

## O que o qxctl abrange

O qxctl implementa administração para:

* Inspeção de repositórios e contratos
* Administração de validador, avisos, invariantes, funcionalidades, ciclo de vida, sessões, reconciliação, associações e Maestro
* Administração de identidade SSIAG, auditoria STAV e produtores Accordare
* Gramática de engines de vetores implementados (`skvi`, `sclv`, `sacv`, `sodv`, `ssfv`, além das superfícies SCV e SHV)

O registo atual contém **373** comandos executáveis.

## Modelo de invocação segura

O qxctl invoca instalações exatas validadas por recibos através de subprocessos limitados, prazos rígidos, verificações de identidade e digest das respostas, transações de estado esperado e recuperação durável. Nunca aceita caminhos de adaptadores nem versões em bruto em vez de recibos.

## Registo de associações de engines v2

O registo de associações de engines v2 suporta as oito funções de engine estabelecidas e identidades de funções futuras limitadas. O estado legado v1 é lido em modo duplo; a migração para v2 exige um compare-and-swap explícito vinculado a digest através do qxctl e nunca é uma operação de seleção de versão.

## Comandos do registo

Gere e verifique o registo esperado a partir de `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
```

Um cliente instalado pode emitir evidência vinculada ao executável:

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

A evidência esperada tem versão do cliente, digest do executável e digest do recibo nulos. A evidência observada vincula a versão exata do cliente e o digest do executável, além de um digest do recibo quando disponível. Ambas as formas utilizam `symphony.qxctl.command-registry.v1`.

> [!NOTE]
>
> O qxctl é responsável pela gramática e pela apresentação dos comandos. Não é responsável pela semântica dos vetores nem pela verdade canónica do conhecimento. Apenas alterações de código-fonte revistas ratificam uma nova identidade `qxcmd`, independentemente da classe do chamador.

## Grupos de comandos

> [card] [knowledge](https://docs.quanux.org/symphony/pt/qxctl/knowledge.md)
>
> Ciclo de vida entre vetores e administração persistente de sessões SSFV.

> [card] [lifecycle](https://docs.quanux.org/symphony/pt/qxctl/lifecycle.md)
>
> Perfil, propriedade, observação, relatório, arranque, aplicação e recuperação.

> [card] [engines](https://docs.quanux.org/symphony/pt/qxctl/engines.md)
>
> Registo de associações de engines e migração.

> [card] [reconcile](https://docs.quanux.org/symphony/pt/qxctl/reconcile.md)
>
> Reconciliação de worktrees do coordenador.

> [card] [session](https://docs.quanux.org/symphony/pt/qxctl/session.md)
>
> Sessões autenticadas e fluxos de manutenção do SSFV.

> [card] [maestro](https://docs.quanux.org/symphony/pt/qxctl/maestro.md)
>
> Inventário derivado de recetores e evidência de acoplamento.

> [card] [validate](https://docs.quanux.org/symphony/pt/qxctl/validate.md)
>
> Política de avisos protegida e administração do validador.

> [card] [comandos de vetores](https://docs.quanux.org/symphony/pt/qxctl/vector-commands.md)
>
> `skvi`, `sclv`, `sacv`, `sodv`, `ssfv`, `shv` e a futura gramática de acordo/evolução.


## Related topics

- [Início rápido: explorar o QuanuX Symphony](https://docs.quanux.org/symphony/pt/quickstart.md)
- [Documentação do QuanuX Symphony](https://docs.quanux.org/symphony/pt/index.md)
- [qxctl validate: política de avisos do Symphony Validator](https://docs.quanux.org/symphony/pt/qxctl/validate.md)
- [qxctl maestro: ler o inventário de presença de recetores do Symphony](https://docs.quanux.org/symphony/pt/qxctl/maestro.md)
- [Arquitetura do Symphony](https://docs.quanux.org/symphony/pt/concepts/architecture.md)


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