Remove Plugin

Uninstall a Claude Code plugin.

Your Task

Remove the plugin specified: $ARGUMENTS

Process

1. Parse Arguments

Extract from $ARGUMENTS:

• Plugin name: Required, format @scope/plugin-name
• Include config: Optional --include-config to also remove settings

2. Locate Plugin

Find the plugin in:

• ~/.claude/plugins/<plugin-name>/
• .claude/plugins/<plugin-name>/

If not found:

❌ Plugin @scope/plugin-name is not installed.

Installed plugins: /plugin-marketplace:list

3. Confirm Removal

Show what will be removed:

🗑️ Remove @claude/git-assistant?

This will remove:
  📁 ~/.claude/plugins/git-assistant/

  Commands:
    • /git-assistant:commit
    • /git-assistant:pr
    • /git-assistant:review

  Skills:
    • commit-message-generation
    • pr-description

  Hooks:
    • pre-commit validation

Configuration file will be PRESERVED:
  📄 ~/.claude/git-assistant.local.md

To also remove configuration, use --include-config

Proceed with removal?

4. Remove Plugin

Execute removal:

# Remove plugin directory
rm -rf ~/.claude/plugins/git-assistant/

# Optionally remove config
rm ~/.claude/git-assistant.local.md  # if --include-config

5. Confirm Removal

✅ Plugin @claude/git-assistant has been removed.

Removed:
  • Plugin files from ~/.claude/plugins/git-assistant/
  • Commands: /git-assistant:commit, /git-assistant:pr, /git-assistant:review
  • Skills: commit-message-generation, pr-description
  • Hooks: pre-commit

Preserved:
  • Configuration: ~/.claude/git-assistant.local.md
    (Delete manually if no longer needed)

To reinstall: /plugin-marketplace:install @claude/git-assistant

With --include-config

✅ Plugin @claude/git-assistant completely removed.

Removed:
  • Plugin files
  • Commands, skills, hooks
  • Configuration file: ~/.claude/git-assistant.local.md

All traces of the plugin have been removed.

Dependency Check

Before removing, check if other plugins depend on this one:

⚠️ Warning: Other plugins depend on @scope/plugin-name

Dependent plugins:
  • @other/plugin-a - uses shared utilities
  • @other/plugin-b - requires this plugin

Removing may break these plugins.

Options:
  • Remove anyway (may cause errors)
  • Cancel removal
  • Remove all dependent plugins first

Error Handling

Permission Denied

❌ Cannot remove ~/.claude/plugins/git-assistant/

Permission denied. Try:
  • Check file permissions
  • Ensure no processes are using plugin files

Plugin Active

⚠️ Plugin @scope/plugin-name is currently active.

The plugin will be disabled before removal.
Proceed?