aggrega version
aggrega version gibt die Version der aggrega-CLI aus.
Ausgabe
Standardmäßig gibt aggrega version eine menschenlesbare Versionszeile aus.
Mit -o json gibt es ein maschinenlesbares Objekt aus, mit zwei Leerzeichen eingerückt, in derselben Form, die jeder aggrega-Befehl für seine JSON-Ausgabe verwendet. Lesen Sie es mit einem JSON-Parser; ein Konsument, der stattdessen auf den Text abgleicht, sollte vor dem Abgleich Leerraum entfernen, weil die Feldnamen der Vertrag sind und das umgebende Layout nicht.
{ "version": "1.2.3", "committed": "2026-07-09T18:07:57Z", "commit": "a1b2c3d", "abiVersion": "v1beta1", "goVersion": "go1.23.0", "platform": "linux/amd64"}Die Felder stammen aus den eingebetteten Build-Metadaten der Binärdatei. committed ist der Commit-Zeitstempel und nur vorhanden, wenn der Build einen verzeichnet hat. abiVersion ist die Plugin-ABI-Version, die die Binärdatei spricht und die eine Pipeline lesen kann, um die Plugin-Kompatibilität zu prüfen, ohne ein Plugin zu laden. Ein Entwicklungs-Build ohne eingebettete Version meldet einen Sentinel-Wert (etwa (devel)), statt fehlzuschlagen.
Wann -o json zu verwenden ist
- Eine Editor-Erweiterung vergleicht die vom Daemon gemeldete Version mit der Version, für die sie gebaut wurde, um eine inkompatible
aggrega serve-Binärdatei zu erkennen, bevor sie sie ansteuert. - CI- und Provenienz-Werkzeuge verzeichnen den genauen Compiler-Build, der ein Artefakt erzeugt hat.
Siehe auch
- ./aggrega-serve.md — der Daemon, dessen Version ein Client auf Kompatibilität prüft.
Übersicht
aggrega version [flags]Beschreibung
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 | Standard | Beschreibung |
|---|---|---|
--output, -o | text | Ausgabeformat: text|json. |
--verbose | false | die Menge der eingebetteten Plugins in die Ausgabe aufnehmen |