nself version

Show the installed nSelf CLI version, Go runtime version, commit SHA, build date, and target platform.

Quick start

# Full version info
nself version

# Just the version number (for scripts)
nself version --short

# Machine-readable JSON
nself version --json

Synopsis

nself version [FLAGS]

Description

nself version prints build metadata stamped into the binary at compile time. This is the fastest way to confirm what version is installed and to capture system info when filing a bug report.

The short form (--short) emits only the semantic version string — useful for shell scripts that pass the version to other commands or to nself verify-sbom.

Output format

nself version
# nself version 1.1.0 (go1.22.3, darwin/arm64)
# commit: a3f8d2e
# built:  2026-05-07T14:22:00Z

nself version --short
# 1.1.0

nself version --json
# {
#   "version": "1.1.0",
#   "goVersion": "go1.22.3",
#   "os": "darwin",
#   "arch": "arm64",
#   "commit": "a3f8d2e",
#   "buildDate": "2026-05-07T14:22:00Z"
# }

Flags

Fields

Examples

Check if a minimum version is installed

INSTALLED=$(nself version --short)
REQUIRED="1.1.0"
if [ "$(printf '%s
' "$REQUIRED" "$INSTALLED" | sort -V | head -n1)" != "$REQUIRED" ]; then
  echo "nself $REQUIRED or newer is required (got $INSTALLED)"
  exit 1
fi

Use in a CI job summary

echo "Running nself $(nself version --short) on $(uname -m)"

Verify the SBOM for the installed version

nself verify-sbom "v$(nself version --short)"

Include version in a bug report

nself version --json | jq '{version, goVersion, os, arch, commit}'

Related

• nself update — update the CLI to the latest release
• nself upgrade — upgrade the CLI binary in-place
• nself verify-sbom — verify the SBOM for this release
• nself release-status — compare installed version against latest release artifacts