> ## 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 comando administrativa agêntica do Symphony

> qxctl é a CLI administrativa em Go do Symphony. Conheça seus 373 comandos executáveis, o registro de vinculação de engines v2 e o modelo de invocação segura para engines.

`qxctl` é a CLI administrativa e de consultas do Symphony, escrita em Go e projetada com prioridade para agentes. Ela fala em comandos; os vetores de domínio são donos das operações e dos significados por trás deles. Seu registro versionado vincula cada folha de comando executável a uma identidade de máquina estável e a evidências revisadas de administração de features.

## O que o qxctl abrange

O qxctl implementa a administração de:

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

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

## Modelo de invocação segura

O qxctl invoca instalações exatas validadas por recibos usando subprocessos delimitados, prazos rígidos, verificações de identidade e digest das respostas, transações de estado esperado e recuperação durável. Ele nunca aceita caminhos de adaptadores ou versões brutas no lugar de recibos.

## Registro de vinculação de engines v2

O registro de vinculação de engines v2 oferece suporte aos oito papéis de engine estabelecidos e a identidades de papéis futuros delimitadas. O estado legado v1 tem leitura dupla; a migração para a v2 exige um compare-and-swap explícito vinculado a digest por meio do qxctl e nunca é uma operação de seleção de versão.

## Comandos do registro

Gere e verifique o registro 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ências vinculadas ao executável:

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

As evidências esperadas têm versão do cliente, digest do executável e digest do recibo nulos. As evidências observadas vinculam a versão exata do cliente e o digest do executável, além de um digest de recibo quando disponível. Ambas as formas usam `symphony.qxctl.command-registry.v1`.

> [!NOTE]
>
> O qxctl é dono da gramática e da apresentação dos comandos. Ele não é dono da semântica dos vetores nem da verdade canônica do conhecimento. Somente alterações de código revisadas ratificam uma nova identidade `qxcmd`, independentemente da classe do chamador.

## Grupos de comandos

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

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

> [card] [engines](https://docs.quanux.org/symphony/pt-BR/qxctl/engines.md)
>
> Registro de vinculação de engines e migração.

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

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

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

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

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


## Related topics

- [Symphony Ops Vector: controle de operações com o qxctl](https://docs.quanux.org/symphony/pt-BR/vectors/sov.md)
- [Início rápido: explore o QuanuX Symphony](https://docs.quanux.org/symphony/pt-BR/quickstart.md)
- [Documentação do QuanuX Symphony](https://docs.quanux.org/symphony/pt-BR/index.md)
- [Neutralidade quanto à classe do chamador e autoridade do host no Symphony](https://docs.quanux.org/symphony/pt-BR/concepts/caller-authority.md)
- [qxctl maestro: leitura do inventário de presença de receptores do Symphony](https://docs.quanux.org/symphony/pt-BR/qxctl/maestro.md)


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