aix remove

Removes every matching item from detected user editor config by default. ai.json is optional. Before confirmation, aix prints each editor and item it will change. Pass --project to remove project editor config, and pass --save to also remove the entry from ai.json or ai.local.json.

For skills, aix removes both the managed .aix/skills/{name}/ copy and any native editor link for the selected scope before regenerating pointer-style rule output where needed.

Usage

aix remove <type> <name> [flags]

<name> is the item name, or the event name for aix remove hook.

Commands

aix remove skill

aix remove skill react

aix remove mcp

aix remove mcp github

Also cleans up global MCP config if the server is no longer used by any project.

aix remove agent

aix remove agent <name>
aix remove agent reviewer --yes

Removes the agent from ai.json (or ai.local.json) and deletes the generated agent files across all configured editors.

aix remove hook

aix remove hook pre_command
aix remove hook session_start --user --target claude-code

Removes the event from ai.json and every entry your editors hold for it, including entries you wrote by hand. Hooks belonging to other events survive even when they share a native event name: removing pre_command from Claude Code drops the PreToolUse groups matching Bash and leaves a pre_file_write group matching Write|Edit in place. With --user, ai.json is neither read nor written, matching aix add hook --user.

aix remove plugin

aix remove plugin <name>
aix remove plugin skill-creator@claude-plugins-official --yes

Removes the plugin from ai.json and uninstalls/unregisters it from configured editors.

aix remove marketplace

aix remove marketplace <name>
aix remove marketplace claude-plugins-official --yes

Removes the marketplace from ai.json and unregisters it from configured editors.

Flags

Flag	Description
--local / -l	Remove from ai.local.json.
--yes / -y	Skip confirmation prompt.
--save / -s	Also remove the item from ai.json.
--target <editor> / -t	Limit removal to named editors. Repeatable.
--no-delete	Skip deleting files from editors (for skills).
--no-sync	Skip syncing editor config (for MCP and hooks).
--scope <scope> / --user (-u) / --project (-p)	Target user or project editor config.