ak commands remove

Use ak commands remove to delete one flat per-command copy from the configured user plugin root. It does not remove the source template, uninstall the kit, or clean up other runtime artifacts.

Usage

ak commands remove <kit>/<command>

Use the flattened command name, such as marketing/ckm-email, not the slash name ckm:email. Exactly one valid ref is required. The short forms ak:<command>, ake:<command>, and akm:<command> are also accepted.

There are no command-specific flags. The command never prompts and ignores stdin for confirmation.

Exact effect

For marketing/ckm-email, the only target is:

~/.claude/plugins/marketing/commands/ckm-email.md

AGENTKIT_PLUGIN_DIR replaces the root. The command leaves source files under ./kits, parent directories, sibling templates, other kits, runtime settings, cache data, and environments untouched. An absent target or a directory at the exact target is reported as not installed and exits 0.

Ownership and recovery boundary

The remover does not read lifecycle ownership, compare a stored hash, protect a modified file, create a snapshot, or request confirmation. Any regular file at the resolved destination is treated as removable.

Make a manual copy before removal if you edited the installed template. A later ak commands install can recreate the file only from the currently selected local source; it cannot restore removed local edits or the original nested slash identity.

Output

Human stdout reports either removed or nothing to remove. JSON success uses schema_version: 1, kind: assets.remove, and these data fields:

ref, kit, asset
removed: boolean
not_installed: boolean

Errors go to stderr. There is no preview, dry-run, force, backup, NDJSON, network, auth, or entitlement behavior.

Exit behavior

Related commands

• Complete ak commands remove command facts
• List command state
• Remove a complete kit route