aggrega version
aggrega version affiche la version de la CLI aggrega.
Sortie
Par défaut, aggrega version affiche une ligne de version lisible par un humain.
Avec -o json, il émet un objet lisible par une machine, indenté de deux espaces, sous la même forme que celle qu’utilise chaque commande aggrega pour sa sortie JSON. Lisez-le avec un parseur JSON ; un consommateur qui effectue plutôt une correspondance sur le texte doit supprimer les espaces avant la correspondance, car les noms de champs constituent le contrat, et non la mise en page environnante.
{ "version": "1.2.3", "committed": "2026-07-09T18:07:57Z", "commit": "a1b2c3d", "abiVersion": "v1beta1", "goVersion": "go1.23.0", "platform": "linux/amd64"}Les champs proviennent des métadonnées de build intégrées au binaire. committed est l’horodatage du commit, et n’est présent que lorsque la build en a enregistré un. abiVersion est la version de l’ABI des plugins que parle le binaire, qu’un pipeline peut lire pour vérifier la compatibilité des plugins sans charger de plugin. Une build de développement qui ne porte aucune version intégrée rapporte une valeur sentinelle (telle que (devel)) plutôt que d’échouer.
Quand utiliser -o json
- Une extension d’éditeur compare la version rapportée par le démon à la version pour laquelle elle a été construite, afin de détecter un binaire
aggrega serveincompatible avant de le piloter. - Les outils de CI et de provenance enregistrent la build exacte du compilateur qui a produit un artefact.
Voir aussi
- ./aggrega-serve.md — le démon dont un client vérifie la version pour la compatibilité.
Synopsis
aggrega version [flags]Description
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.Options
| Option | Par défaut | Description |
|---|---|---|
--output, -o | text | Format de sortie : text|json. |
--verbose | false | inclure dans la sortie l’ensemble des plugins intégrés |