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 kit repair-install-mode

Repair mixed Claude Code native and project-plugin state

Resolve active mixed Claude Code mode without reinstalling or guessing the original kit source. The repair keeps the existing native install and deactivates only fingerprinted AgentKit project-plugin state.

Who it's for: Users following an ak doctor mixed-install-mode finding.

When to use it: Run through ak doctor --fix, or directly after reviewing the project plugin cleanup.

What changes on disk: Creates recovery snapshots, deactivates project-scoped AgentKit plugins, and preserves native and user-modified files.

Usage

ak kit repair-install-mode [flags]

Examples

ak kit repair-install-mode --keep native --yes
ak kit repair-install-mode --keep native --project-dir ./app --yes

Flags

FlagDescription
-h, --helphelp for repair-install-mode
--jsonEmit machine-readable JSON (implies --no-interactive)
--keep stringInstall mode to preserve (required: native)
--no-interactiveDisable interactive prompts (CI-safe)
--project-dir stringProject containing the conflicting plugin (defaults to current directory)
-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)
  • ak kit — Kit management commands

On this page