ak self-update

ak self-update

Check or apply signed AgentKit binary updates

Synopsis

What it does: Check the signed AgentKit binary update manifest from the configured release registry. Manual CLI apply requires --yes. Desktop auto-update is opt-in only and is controlled by updates.enabled in ~/.agentkit/config.yaml.

Who it's for: Users who want AgentKit itself updated from the Cloudflare-backed release channel.

When to use it: Use this instead of ak update when updating the ak binary or staging a desktop update.

Examples: ak self-update --check ak self-update --changelog ak self-update --yes ak self-update --include-desktop --yes ak self-update --enable-auto-update ak self-update --disable-auto-update ak self-update --channel stable --json

What changes on disk: Check mode is read-only. Package-manager-owned binaries report the manager-native upgrade command. --enable-auto-update/--disable-auto-update writes ~/.agentkit/config.yaml. Apply mode downloads verified artifacts into ~/.agentkit/cache/binaries and replaces the CLI binary only after all required bytes verify. Desktop updates are staged atomically and require restart/handoff.

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

Exit codes: 0 success 1 runtime error 2 invalid flags 3 user-cancel (SIGINT, prompt-cancel) 1 network, verification, staging, or replacement error 2 invalid flags

ak self-update [flags]

Options

      --changelog             Print the verified release changelog without checking or applying updates
      --channel string        Binary update channel (dev, beta, stable; default from config or beta)
      --check                 Check for a binary update without applying it
      --disable-auto-update   Opt out of desktop auto-update
      --dry-run               Verify and plan the update without mutating disk
      --enable-auto-update    Opt in to desktop auto-update checks and staged apply
  -h, --help                  help for self-update
      --include-desktop       Require matching CLI and desktop artifacts for this platform
      --json                  Emit machine-readable JSON (implies --no-interactive)
      --kit string            When using --changelog, filter one public kit: engineer or marketing
      --no-interactive        Disable interactive prompts (CI-safe)
  -q, --quiet                 Suppress non-error output on stderr
      --registry-url string   Binary update registry root (default $AGENTKIT_BINARY_UPDATE_URL or release domain)
      --target strings        When using --changelog, filter target: all, cli, app, kits, engineer, or marketing
  -V, --verbose               Extra diagnostic output on stderr (loses to --quiet)
      --version string        Resolve a specific binary version instead of the channel pointer
  -y, --yes                   Assume yes for all prompts

SEE ALSO

• ak - AgentKit CLI