Charter — AI-Agent Readiness Scanner

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 --short

charter version --format json

charter version output — charter version — build metadata for the installed binary

Flags

boolean

Print only the version number. Bypasses format rendering entirely — --format is ignored when --short is set.

text | json

Output format. Defaults to text. Ignored when --short is set.

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"
}

Exit codes

Code	Meaning	When
`0`	Pass	Version output rendered successfully
`2`	Error	A usage error — for example, an unknown `--format` value when `--short` is not set

Installation

Install or upgrade the Charter binary.

doctor

The primary command once the binary is installed.

​Usage

​Flags

​Example Output

​JSON Output

​Exit codes

​Related