ak versions

Show the current ak binary version alongside every locally available kit and installed skill. Live latest-version comparison is disabled until the AgentKit versions registry endpoint is deployed; cached latest fields are best-effort and may be empty.

Who it's for: Both: power devs (--json for scripting) and non-technical users (default pretty output).

When to use it: Audit what is installed locally or diagnose version mismatches.

What changes on disk: Read-only unless a versions registry endpoint is configured and returns a fresh cacheable response.

Usage

ak versions [flags]

Examples

ak versions                     # local inventory
ak versions --local-only        # local inventory; no registry/cache lookup
ak versions --json              # machine-readable JSON
ak versions --cache-ttl 30m     # shorten TTL for registry cache reads

Flags

Flag	Description
`--cache-ttl duration`	Registry cache TTL (e.g. 30m, 2h) (default 1h0m0s)
`-h, --help`	help for versions
`--json`	Emit machine-readable JSON (implies --no-interactive)
`--local-only`	Skip registry fetch; show only installed versions
`--no-interactive`	Disable interactive prompts (CI-safe)
`-q, --quiet`	Suppress non-error output on stderr
`--remote-only`	Reserved for a configured versions registry endpoint; skip local enumeration
`-V, --verbose`	Extra diagnostic output on stderr (loses to --quiet)
`-y, --yes`	Assume yes for all prompts

Output modes

Mode	Behavior
`pretty`	default on TTY (colors, ASCII markers)
`plain`	auto when stdout piped or --no-interactive
`json`	--json (single-object envelope, NDJSON-safe)

Exit codes

Code	Meaning
`0`	success
`1`	runtime error
`2`	invalid flags
`3`	user-cancel (SIGINT, prompt-cancel)
`1`	local enumeration failed (e.g. unreadable install root)
`2`	invalid flags

ak — AgentKit CLI

Usage

Examples

Flags

Output modes

Exit codes

Related commands

On this page