AgentKit
ReferenceCLI commands
BetaYou are reading docs for the beta channel (2.4.1-beta.1) — updated automatically on every beta release.Switch to stable →

CLI commands

ak backups show

Print the manifest of a single snapshot

Print the per-file manifest for one snapshot, including sha256 hashes, sizes, and the on-host source paths each file was captured from.

Who it's for: Power devs auditing what would be restored before pulling the trigger.

When to use it: Sanity-check before ak backups restore; debug discrepancies surfaced by verify.

What changes on disk: Read-only.

Usage

ak backups show <id> [flags]

Examples

ak backups show 20260426T123005Z-deadbeef
ak backups show 20260426T123005Z-deadbeef --json

Flags

FlagDescription
-h, --helphelp for show
--jsonEmit machine-readable JSON (implies --no-interactive)
--no-interactiveDisable interactive prompts (CI-safe)
-q, --quietSuppress non-error output on stderr
-V, --verboseExtra diagnostic output on stderr (loses to --quiet)
-y, --yesAssume yes for all prompts

Output modes

ModeBehavior
prettydefault on TTY (colors, ASCII markers)
plainauto when stdout piped or --no-interactive
json--json (single-object envelope, NDJSON-safe)

Exit codes

CodeMeaning
0success
1runtime error
2invalid flags
3user-cancel (SIGINT, prompt-cancel)
5snapshot id not found

On this page