gh-husniadil-cc-hooks/commands/update.md

allowed-tools, description

allowed-tools	description
Bash	Check for cc-hooks updates and install if available

cc-hooks Update Assistant

Check for cc-hooks updates and install them if available.

Update Check Flow

1. Detect Installation Mode

Determine if cc-hooks is running in plugin mode or standalone mode by checking the hooks configuration:

# Detect installation mode
python3 -c "
import json, sys, os

# Check 1: Plugin mode - hooks defined in plugin directory
plugin_hooks_file = os.path.expanduser('~/.claude/plugins/marketplaces/cc-hooks-plugin/hooks/hooks.json')
if os.path.isfile(plugin_hooks_file):
    try:
        with open(plugin_hooks_file, 'r') as f:
            config = json.load(f)
            # Verify it has hooks configuration
            if config.get('hooks') and len(config['hooks']) > 0:
                # Verify hooks.py exists
                plugin_hooks_py = os.path.expanduser('~/.claude/plugins/marketplaces/cc-hooks-plugin/hooks.py')
                if os.path.isfile(plugin_hooks_py):
                    print('plugin')
                    sys.exit(0)
    except:
        pass

# Check 2: Standalone mode - hooks defined in settings.json
settings_file = os.path.expanduser('~/.claude/settings.json')
if os.path.isfile(settings_file):
    try:
        with open(settings_file, 'r') as f:
            config = json.load(f)
            hooks = config.get('hooks', {})
            # Check if any hook points to hooks.py
            for event_hooks in hooks.values():
                if isinstance(event_hooks, list):
                    for matcher_group in event_hooks:
                        for hook in matcher_group.get('hooks', []):
                            command = hook.get('command', '')
                            if 'hooks.py' in command:
                                print('standalone')
                                sys.exit(0)
    except:
        pass

print('unknown')
"

Detection Logic:

1. Check Plugin Mode First:

   • Look for ~/.claude/plugins/marketplaces/cc-hooks-plugin/hooks/hooks.json
   • Verify it contains valid hooks configuration
   • Verify hooks.py exists at ~/.claude/plugins/marketplaces/cc-hooks-plugin/hooks.py
   • If all checks pass → Plugin mode

2. Check Standalone Mode:

   • Read ~/.claude/settings.json
   • Check the hooks field (MUST be exactly hooks, not #hooks_disabled)
   • Look for any hook command containing hooks.py
   • If found → Standalone mode

3. If neither:

   • Result: Unknown (cc-hooks not configured)

Why this order matters:

• In plugin mode, hooks are NOT in ~/.claude/settings.json
• In plugin mode, hooks are in ~/.claude/plugins/marketplaces/cc-hooks-plugin/hooks/hooks.json
• Must check plugin directory first before checking settings.json

Example configurations:

Plugin mode: ~/.claude/plugins/marketplaces/cc-hooks-plugin/hooks/hooks.json

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [{ "type": "command", "command": "uv run ${CLAUDE_PLUGIN_ROOT}/hooks.py" }]
      }
    ]
  }
}

Standalone mode: ~/.claude/settings.json

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [{ "type": "command", "command": "uv run /Users/username/cc-hooks/hooks.py" }]
      }
    ]
  }
}

2. Check for Updates

Query the cc-hooks server for version status:

# Try to get version status from the server
curl -s http://localhost:12222/version/status 2>/dev/null || \
curl -s http://localhost:12223/version/status 2>/dev/null || \
curl -s http://localhost:12224/version/status 2>/dev/null || \
echo '{"error": "Server not running"}'

Important: Try multiple ports (12222, 12223, 12224) as the server may be running on different ports for different instances.

3. Parse Version Information

From the API response, extract:

• update_available (boolean)
• current_version (string)
• latest_version (string)
• commits_behind (number)

4. Display Status

If server is not running or error:

❌ Cannot check for updates: cc-hooks server is not running
💡 Start Claude Code with cc-hooks to check for updates

If no update available:

✅ cc-hooks is up to date
📌 Current version: {current_version}

If update available:

⚠️  Update available for cc-hooks

Current version: {current_version}
Latest version:  {latest_version}
Commits behind:  {commits_behind}

Would you like to update now?

5. Offer to Update

If update is available, ask the user if they would like to proceed with the update now.

• If the user confirms → Proceed with update
• If the user declines → Skip update and show them how to update manually later

6. Execute Update

For Plugin Mode:

claude plugin marketplace update cc-hooks-plugin

For Standalone Mode:

cd {repo_root} && npm run update

After update:

✅ cc-hooks has been updated to {latest_version}
⚠️  Please restart your Claude Code session for changes to take effect

Error Handling

If update command fails:

❌ Update failed. Please try manually:

Plugin mode:
  claude plugin marketplace update cc-hooks-plugin

Standalone mode:
  cd {repo_root}
  npm run update

If the update continues to fail or you encounter a bug:

Direct the user to report the issue on GitHub: https://github.com/husniadil/cc-hooks/issues/new

Include in the report:

• Current version (from error message or /version/status endpoint)
• Installation mode (plugin or standalone)
• Full error message
• OS and shell information
• Steps attempted before failure

Example Session

$ /cc-hooks-plugin:update

Checking for cc-hooks updates...

⚠️  Update available for cc-hooks

Current version: v1.0.0
Latest version:  v1.0.1
Commits behind:  3

Would you like to update now? [Yes/No]
> Yes

Updating cc-hooks...
✅ cc-hooks has been updated to v1.0.1
⚠️  Please restart your Claude Code session for changes to take effect

Implementation Notes

• Always check server availability first
• Try multiple ports (race condition during server startup)
• Detect installation mode from current working directory
• Use appropriate update command based on mode
• Always remind user to restart Claude Code after update
• Handle connection errors gracefully
• If update fails or bugs are found: Direct users to https://github.com/husniadil/cc-hooks/issues/new