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 migrate
Migrate an existing ClaudeKit install to AgentKit
Discover, classify, and migrate a ClaudeKit (ck) install to AgentKit. Scans ~/.claude/, ~/.claudekit/, and the current directory for ClaudeKit artifacts, produces a per-user migration plan, and applies it. Dry-run by default; no files are written without explicit opt-in.
Who it's for: Both: power devs (--no-interactive --json --from=ck) and non-tech users (TUI defaults).
When to use it: When moving an existing ClaudeKit setup to AgentKit for the first time, or re-running after partial migration.
What changes on disk: Read-only with --dry-run (default). Without --dry-run, writes files under the migration target only after --yes and the runtime safety gates pass.
Usage
ak migrate [flags]Examples
ak migrate # interactive TUI, dry-run
ak migrate --from=ck # explicit source (default)
ak migrate --from=ck --dry-run=false --yes # apply a global/native migration
ak migrate --from=ck --switch-to-plugin --dry-run=false --yes # apply a project plugin migration
ak migrate --from=ck --json # machine-readable status
ak migrate --from=ck --no-interactive --dry-run=false --yes # CI applyFlags
| Flag | Description |
|---|---|
--dry-run | Preview migration plan without writing any files (default true) |
--force-unlock | Remove a stale migration lock left by a previously crashed migration before proceeding |
--from string | Source to migrate from (currently supports "ck" for ClaudeKit) (default "ck") |
-h, --help | help for migrate |
--json | Emit machine-readable JSON (implies --no-interactive) |
--no-interactive | Disable interactive prompts (CI-safe) |
-q, --quiet | Suppress non-error output on stderr |
--switch-to-plugin | Explicitly authorize Claude Code project plugin delivery in the migration plan |
-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) |
Related commands
ak— AgentKit CLIak migrate rollback— Roll back a failed migration to its pre-apply state