2.4.1-beta.1) — updated automatically on every beta release.Switch to stable →CLI commands
ak self-update
Check or apply signed AgentKit binary updates
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.
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.
Usage
ak self-update [flags]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 --jsonFlags
| Flag | Description |
|---|---|
--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 |
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 | network, verification, staging, or replacement error |
2 | invalid flags |
Related commands
ak— AgentKit CLI