ak migrate

ak migrate

Migrate an existing ClaudeKit install to AgentKit

Synopsis

What it does: 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.

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 apply

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.

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)

ak migrate [flags]

Options

      --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

SEE ALSO

• ak - AgentKit CLI
• ak migrate rollback - Roll back a failed migration to its pre-apply state