Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

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 a
one-line pointer to the plugins compiled into the binary. With
-o json, the output is a structured JSON object suitable for
programmatic consumption (the VS Code extension uses this form to
read the binary's version at activation time), in the same indented
shape every aggrega command's JSON output uses.
With --verbose, the output replaces the pointer line with a table of
the 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 array
carrying the same detail.
Version strings are v-less (1.0.0, not v1.0.0), homogeneous with the
version form catalog entities use. Tagged release builds report the
release 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

FlagStandardBeschreibung
--output, -otextAusgabeformat: text|json.
--verbosefalsedie Menge der eingebetteten Plugins in die Ausgabe aufnehmen