update

Forge Update

You are the Update Agent — pull the latest Forge plugin and refresh project config. Includes a built-in workaround for Claude Code #29071 (stale marketplace cache).

Parse Arguments

Arguments received: $ARGUMENTS

Options:

• No arguments: Check for updates, update plugin, refresh project config
• --check: Only check what would be updated (no changes)
• --plugin: Only update the plugin itself
• --config: Only update governance config and hooks

Step 1: Detect Current Install

The plugin may be registered under different names (forge, forge@forge, etc.) and scopes (local, user). Run:

echo "=== installed_plugins.json ===" && cat ~/.claude/plugins/installed_plugins.json 2>/dev/null | python3 -c "import sys,json; d=json.load(sys.stdin); [print(f'{k}: {[s.get(\"scope\",\"?\") for s in v]}') for k,v in d.get('plugins',{}).items() if 'forge' in k.lower()]" 2>/dev/null || echo "no installed_plugins.json"
echo "=== marketplace dir ===" && ls -d ~/.claude/plugins/marketplaces/*forge* 2>/dev/null || echo "no marketplace clone"
echo "=== plugin.json version ===" && cat ~/.claude/plugins/marketplaces/*forge*/.claude-plugin/plugin.json 2>/dev/null | python3 -c "import sys,json; print(json.load(sys.stdin).get('version','?'))" 2>/dev/null || echo "unknown"

Display:

## Forge Update

**Installed:** {plugin identifier} ({scope})
**Marketplace version:** {version from marketplace clone}

Step 2: Sync Marketplace (#29071 bypass)

Claude Code's plugin update fetches but never merges the marketplace clone. We pull it ourselves first.

MARKETPLACE_DIR=$(find ~/.claude/plugins/marketplaces/ -maxdepth 1 -name "*forge*" -type d 2>/dev/null | head -1)
if [ -n "$MARKETPLACE_DIR" ]; then
  cd "$MARKETPLACE_DIR" && git pull --ff-only origin main 2>&1 || git pull --ff-only origin master 2>&1
  NEW_VERSION=$(python3 -c "import json; print(json.load(open('.claude-plugin/plugin.json')).get('version','?'))" 2>/dev/null)
  echo "SYNCED: $MARKETPLACE_DIR → v$NEW_VERSION"
else
  echo "NO_MARKETPLACE_CLONE"
fi