bacchus-labs/updating-wrangler

Update Wrangler Plugin

This skill updates the wrangler plugin to the latest version from GitHub by clearing all caching layers.

When to Use

• User says "update yourself" or "update wrangler"
• After pushing changes to the wrangler GitHub repo
• When slash commands or skills aren't showing up after changes
• When plugin behavior doesn't match the latest code

Background: The Caching Problem

Claude Code's plugin system has three layers that can get out of sync:

| Layer | Location | Purpose | |-------|----------|---------| | GitHub | Remote repository | Source of truth | | Marketplace clone | ~/.claude/plugins/marketplaces/{marketplace}/ | Local git clone | | Installed cache | ~/.claude/plugins/cache/{marketplace}/wrangler/ | Files Claude Code uses |

The /plugin command only reads from the marketplace clone, and only re-installs if version changes. Pushing to GitHub doesn't update the other layers.

Instructions

Step 1: Find the Marketplace Name

# Find which marketplace wrangler is installed from
grep -l wrangler ~/.claude/plugins/marketplaces/*/plugin.json 2>/dev/null | head -1 | xargs dirname | xargs basename

Or check ~/.claude/plugins/installed_plugins.json for the key containing "wrangler" (e.g., wrangler@samjhecht-plugins means marketplace is samjhecht-plugins).

Step 2: Update All Layers

Execute these commands (replace {marketplace} with actual name):

# 1. Update the marketplace clone
cd ~/.claude/plugins/marketplaces/{marketplace} && git fetch origin && git reset --hard origin/main && cd -

# 2. Clear the installed cache
rm -rf ~/.claude/plugins/cache/{marketplace}/wrangler/

# 3. Rebuild MCP bundle (CRITICAL - Claude Code doesn't run postinstall)
cd ~/.claude/plugins/marketplaces/{marketplace} && npm install && cd -

# 4. Reset installed_plugins.json entry (forces reinstall)

Step 3 rebuilds the MCP bundle. This is critical because Claude Code copies plugin files but doesn't run npm install or postinstall scripts. The MCP server requires mcp/dist/bundle.cjs which is built by the postinstall script.

For step 4, edit ~/.claude/plugins/installed_plugins.json and set the wrangler entry to an empty array:

"wrangler@{marketplace}": []

Step 3: Inform User

Tell the user:

Wrangler plugin cache cleared. Please restart Claude Code to complete the update.

The plugin will reinstall from the latest code on next startup.

Automated Script

Execute the script directly:

./scripts/update-wrangler.sh

Or offer to add it to the user's shell config for easy access:

# Add to ~/.zshrc or ~/.bashrc
source /path/to/wrangler/skills/updating-wrangler/scripts/update-wrangler.sh

# Then just run:
update-wrangler

The script (scripts/update-wrangler.sh) handles:

• Finding the marketplace name automatically
• Updating the marketplace clone from origin
• Clearing the plugin cache
• Resetting the installed_plugins.json entry

Requires: jq for JSON manipulation (falls back to manual instructions if not installed)

Manual Alternative

If the user prefers not to use the script, provide these manual steps:

1. Find your marketplace name in ~/.claude/plugins/installed_plugins.json
2. Pull latest code: cd ~/.claude/plugins/marketplaces/{marketplace} && git pull
3. Delete cache: rm -rf ~/.claude/plugins/cache/{marketplace}/wrangler/
4. Rebuild MCP bundle: cd ~/.claude/plugins/marketplaces/{marketplace} && npm install
5. Edit ~/.claude/plugins/installed_plugins.json - set wrangler entry to []
6. Restart Claude Code

Verification

After restart, verify the update worked:

# Check the installed commit
cat ~/.claude/plugins/installed_plugins.json | grep -A5 wrangler

# Check commands exist
ls ~/.claude/plugins/cache/{marketplace}/wrangler/*/commands/

Why This Is Necessary

• Version numbers alone don't trigger updates (same version = no reinstall)
• The marketplace clone is a local git repo that doesn't auto-fetch
• installed_plugins.json caches the commit SHA and won't reinstall unless cleared
• All three layers must be updated for changes to take effect