ak kit

ak kit

Kit management commands

Synopsis

What it does: Commands for working with AgentKit content kits: list, validate, init, refresh, install-path, uninstall.

Who it's for: Both power devs (CLI scripting) and non-technical users (TUI fallback).

When to use it: Use as the entry point for kit discovery, validation, install/build, path lookup, and cleanup.

Examples: ak kit list-kits # show bundled or overridden kits ak kit validate kits/ # schema-check local kit.yaml files ak kit init engineer --remote --target claude-code --switch-to-plugin # authenticated project plugin ak kit init engineer --remote --target codex # authenticated Codex install ak kit init engineer --kits-dir ./kits --target codex # explicit local development source ak kit init engineer --remote --switch-to-plugin --yes --json --no-interactive # scripted project install ak kit refresh engineer --remote --yes # refresh a paid registry kit ak kit install-path engineer --json # resolve install destination ak kit uninstall engineer --dry-run # preview safe uninstall

What changes on disk: Read-only at this group level; subcommands document their own effects.

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)

Options

  -h, --help             help for kit
      --json             Emit machine-readable JSON (implies --no-interactive)
      --no-interactive   Disable interactive prompts (CI-safe)
  -q, --quiet            Suppress non-error output on stderr
  -V, --verbose          Extra diagnostic output on stderr (loses to --quiet)
  -y, --yes              Assume yes for all prompts

SEE ALSO

• ak - AgentKit CLI
• ak kit init - Install or build a kit
• ak kit install - Install a kit into the current project or adapter user directory
• ak kit install-path - Print the resolved OS install path for a kit
• ak kit list-kits - List available content kits
• ak kit refresh - Refresh an installed kit and remove stale generated files
• ak kit repair-install-mode - Repair mixed Claude Code native and project-plugin state
• ak kit uninstall - Remove an installed kit plugin
• ak kit validate - Validate kit.yaml files in a kits directory