aggrega version
aggrega version imprime a versão da CLI aggrega.
Saída
Por padrão, aggrega version imprime uma linha de versão legível por humanos.
Com -o json, ele emite um objeto legível por máquina, com recuo de dois espaços, na mesma forma que todo comando aggrega usa para sua saída JSON. Leia-o com um parser JSON; um consumidor que, em vez disso, faz correspondência no texto deve remover os espaços em branco antes de comparar, porque os nomes dos campos são o contrato e o layout ao redor não é.
{ "version": "1.2.3", "committed": "2026-07-09T18:07:57Z", "commit": "a1b2c3d", "abiVersion": "v1beta1", "goVersion": "go1.23.0", "platform": "linux/amd64"}Os campos vêm dos metadados de build incorporados ao binário. committed é o timestamp do commit, e só está presente quando o build registrou um. abiVersion é a versão da ABI de plugins que o binário fala, que um pipeline pode ler para verificar a compatibilidade de plugins sem carregar nenhum plugin. Um build de desenvolvimento que não traz nenhuma versão incorporada relata um valor sentinela (como (devel)) em vez de falhar.
Quando usar -o json
- Uma extensão de editor compara a versão relatada pelo daemon com a versão para a qual foi compilada, para detectar um binário
aggrega serveincompatível antes de controlá-lo. - Ferramentas de CI e de proveniência registram o build exato do compilador que produziu um artefato.
Veja também
- ./aggrega-serve.md — o daemon cuja versão um cliente verifica para compatibilidade.
Sinopse
aggrega version [flags]Descrição
Print the aggrega CLI's build identity.
By default the output is a single human-readable line followed by aone-line pointer to the plugins compiled into the binary. With-o json, the output is a structured JSON object suitable forprogrammatic consumption (the VS Code extension uses this form toread the binary's version at activation time), in the same indentedshape every aggrega command's JSON output uses.
With --verbose, the output replaces the pointer line with a table ofthe embedded plugins — type, name, served capabilities, and commit —under a header naming the count and their shared version. With--verbose -o json, the JSON object gains an embeddedPlugins arraycarrying the same detail.
Version strings are v-less (1.0.0, not v1.0.0), homogeneous with theversion form catalog entities use. Tagged release builds report therelease version, a build stamped with a version reports that version,and a build carrying no version stamp reports the literal "(devel)",which marks an unreleased build.Flags
| Flag | Padrão | Descrição |
|---|---|---|
--output, -o | text | Formato de saída: text|json. |
--verbose | false | incluir na saída o conjunto de plugins incorporados |