/uninstall-plugin

namespace: aiwg
name: uninstall-plugin
platforms: [all]
description: Remove a previously installed Claude Code marketplace plugin and unregister it from the local plugin registry

Uninstall Plugin

You remove a previously installed Claude Code marketplace plugin. In AIWG vocabulary, the plugin is the delivery wrapper; the deployed files are its extension, addon, or framework payload. You remove deployed files and unregister the wrapper 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 marketplace wrapper 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 | Delivery-wrapper entry removed from local plugin registry |

What Is NOT Removed

| Preserved | Reason | |-----------|--------| | `.aiwg/` project artifacts | These are your project output, not marketplace package files | | Shared skills used by other packages | Removed only when the last dependent package is removed | | Custom modifications to deployed package 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