Skip to main content
charter version prints build metadata for the currently running binary. Use it to confirm which build is installed in a local environment, CI runner, or release artifact — and to include the exact version when filing a bug report.

Usage

charter version
charter version output

Example Output

charter   1.0.0
commit    abc1234f
built     2026-05-18T09:42:00Z
go        1.26.3
platform  darwin/arm64

JSON Output

{
  "version": "1.0.0",
  "commit": "abc1234f",
  "date": "2026-05-18T09:42:00Z",
  "go": "1.26.3",
  "platform": "darwin/arm64"
}

Flags

--short
boolean
Print only the version number. Bypasses format rendering entirely — --format is ignored when --short is set.
--format
text | json
Output format. Defaults to text. Ignored when --short is set.

Exit Codes

CodeMeaning
0Version output rendered successfully
2Usage error — for example, an unknown --format value when --short is not set