Skip to main content
AI/MLjmagly

uninstall-plugin

Remove a previously installed Claude Code plugin and unregister it from the local plugin registry

Stars
141
Source
jmagly/aiwg
Updated
2026-05-31
Slug
jmagly--aiwg--uninstall-plugin
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/jmagly/aiwg/HEAD/agentic/code/addons/aiwg-utils/skills/uninstall-plugin/SKILL.md -o .claude/skills/uninstall-plugin.md

Drops the SKILL.md into .claude/skills/uninstall-plugin.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Uninstall Plugin

You remove a previously installed Claude Code plugin. You remove deployed plugin files and unregister the plugin from the local plugin registry.

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

  • "get rid of the voice plugin" → uninstall voice@aiwg
  • "I don't need the marketing kit anymore" → uninstall marketing@aiwg
  • "clean up the SDLC agents" → uninstall sdlc@aiwg
  • "remove everything from that plugin" → uninstall with cleanup

Trigger Patterns Reference

Pattern Example Action
Uninstall plugin "uninstall plugin voice@aiwg" Run aiwg uninstall-plugin voice@aiwg
Remove plugin "remove plugin marketing@aiwg" Run aiwg uninstall-plugin marketing@aiwg
Plugin uninstall "plugin uninstall sdlc@aiwg" Run aiwg uninstall-plugin sdlc@aiwg
Dry run "what would removing the voice plugin delete?" Run aiwg uninstall-plugin voice@aiwg --dry-run
Keep artifacts "remove the plugin but keep my .aiwg/ files" Run aiwg uninstall-plugin sdlc@aiwg --keep-artifacts

Behavior

When triggered:

  1. Extract intent:

    • Which plugin is being removed?
    • Is this a dry run (preview) or should changes be applied?
    • Should project artifacts in .aiwg/ be preserved? (default: yes, always preserve)

  2. Run the appropriate command:

    # Uninstall a plugin
aiwg uninstall-plugin sdlc@aiwg
aiwg uninstall-plugin voice@aiwg
aiwg uninstall-plugin marketing@aiwg

# Preview what would be removed
aiwg uninstall-plugin sdlc@aiwg --dry-run

# Keep .aiwg/ project artifacts even if plugin-owned (default behavior)
aiwg uninstall-plugin sdlc@aiwg --keep-artifacts

  3. Report the result — list what was removed (agents, commands, skills, rules) and confirm the plugin is deregistered.

What Gets Removed

Removed Description
Agent files Files in .claude/agents/ that belong to the plugin
Command files Files in .claude/commands/ that belong to the plugin
Skill files Files in .claude/skills/ that belong to the plugin
Rule files Files in .claude/rules/ that belong to the plugin
Registry entry Plugin entry removed from local plugin registry

What Is NOT Removed

Preserved Reason
.aiwg/ project artifacts These are your project output, not plugin files
Shared skills used by other plugins Removed only when last dependent plugin is removed
Custom modifications to plugin files Files modified after install are flagged, not deleted

Examples

Example 1: Remove the voice plugin

User: "Uninstall the voice plugin"

Extraction: Plugin name is voice@aiwg

Action:

aiwg uninstall-plugin voice@aiwg

Response: "Uninstalled voice@aiwg. Removed 6 voice profiles from .claude/skills/voices/, 4 soul system skills, 2 rules. Plugin deregistered."

Example 2: Dry run before removing

User: "What would removing the SDLC plugin delete?"

Extraction: Dry-run for sdlc plugin

Action:

aiwg uninstall-plugin sdlc@aiwg --dry-run

Response: "Dry run — uninstalling sdlc@aiwg would remove: 58 agents from .claude/agents/, 42 commands from .claude/commands/, 12 skills, 33 rules. Your .aiwg/ project artifacts would NOT be affected. No changes made."

Example 3: Plugin not found

User: "Remove the analytics plugin"

Extraction: Plugin name analytics — not in registry

Action:

aiwg uninstall-plugin analytics@aiwg

Response: "Plugin analytics@aiwg is not installed. Run aiwg plugin-status to see what is currently installed."

Clarification Prompts

If the plugin name is ambiguous or not clearly installed:

  • "Which plugin would you like to remove? Installed plugins: sdlc@aiwg, voice@aiwg. Run aiwg plugin-status to confirm."

References

  • @$AIWG_ROOT/src/cli/handlers/utilities.ts — Command handler
  • @$AIWG_ROOT/docs/cli-reference.md — CLI reference