コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

aggrega version

aggrega version は aggrega CLI のバージョンを出力します。

出力

デフォルトでは、aggrega version は人間が読める形式のバージョン行を出力します。

-o json を指定すると、機械可読なオブジェクトを 2 スペースのインデントで出力します。その形は、すべての aggrega コマンドが JSON 出力に使うものと同じです。JSON パーサーで読み取ってください。代わりに テキストで照合するコンシューマーは、照合の前に空白を取り除く必要があります。契約となるのはフィールド名であり、 周囲のレイアウトではないためです。

{
"version": "1.2.3",
"committed": "2026-07-09T18:07:57Z",
"commit": "a1b2c3d",
"abiVersion": "v1beta1",
"goVersion": "go1.23.0",
"platform": "linux/amd64"
}

各フィールドは、バイナリに埋め込まれたビルドメタデータから取得されます。committed はコミットのタイムスタンプで、 ビルドがそれを記録した場合にのみ存在します。abiVersion はバイナリが使用するプラグイン ABI のバージョンで、 パイプラインはこれを読み取ることで、プラグインを読み込まずにプラグインの互換性を確認できます。 埋め込みバージョンを持たない開発ビルドは、失敗する代わりにセンチネル値((devel) など)を 報告します。

-o json を使う場面

  • エディタ拡張機能は、デーモンが報告するバージョンを自身がビルドされた対象のバージョンと比較し、互換性のない aggrega serve バイナリを操作する前に検出します。
  • CI や来歴管理のツールは、成果物を生成したコンパイラのビルドを正確に記録します。

関連項目

  • ./aggrega-serve.md — クライアントが互換性のためにバージョンを確認するデーモンです。

概要

aggrega version [flags]

説明

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.

フラグ

フラグデフォルト説明
--output, -otext出力形式: text|json。
--verbosefalse埋め込みプラグインのセットを出力に含めます