Deliver hooks via Claude Code plugin instead of csb install-hooks

[djdarcy]

Deliver hooks via Claude Code plugin instead of csb install-hooks

Problem

The current plan for csb install-hooks would directly patch ~/.claude/settings.json to add PreCompact and SessionEnd hooks. This is fragile:

• Conflicts with other tools that also modify settings.json
• Manual JSON merging is error-prone
• No clean uninstall/update path
• User has to re-run install-hooks after every csb update

Proposed solution

Create a Claude Code plugin (like claude-session-logger) that registers the hooks cleanly via the plugin system:

Claude-Session-Backup/
  .claude-plugin/
    plugin.json          # Plugin metadata (name, version, author)
  hooks/
    hooks.json           # Hook registrations (PreCompact, SessionEnd)
    scripts/
      backup-hook.py     # Script that runs csb backup --quiet
  commands/
    (optional slash commands)

Plugin hooks.json:

{
  "hooks": [
    {
      "event": "PreCompact",
      "script": "hooks/scripts/backup-hook.py"
    },
    {
      "event": "SessionEnd",
      "script": "hooks/scripts/backup-hook.py"
    }
  ]
}

backup-hook.py:

import subprocess
subprocess.run(["csb", "backup", "--quiet"], capture_output=True)

Install/uninstall

# Install
claude plugin marketplace add "DazzleML/Claude-Session-Backup"
claude plugin install claude-session-backup@dazzle-claude-plugins

# Uninstall
claude plugin uninstall claude-session-backup

Benefits over csb install-hooks

• Clean install/uninstall via plugin system
• No manual settings.json editing
• Updates handled by plugin system
• Coexists cleanly with other plugins (session-logger, etc.)
• Follows established pattern from claude-session-logger

References

• C:\code\claude-projects\claude-session-logger -- reference implementation of Claude Code plugin with hooks
• C:\code\claude-projects\dazzle-claude-vault -- hook patterns (PreCompact, SessionEnd) from claude-vault README

[djdarcy]

Cross-platform hook bootstrapper landed in v0.2.0

Plugin delivery was completed in v0.1.2, but hook execution still had a cross-platform reliability issue: hooks.json invoked python backup-hook.py which fails on Linux systems where python resolves to Python 2 or doesn't exist at all (only python3).

Fix in v0.2.0:

• New hooks/scripts/run-hook.mjs -- Node.js bootstrapper
• hooks.json now calls node run-hook.mjs for both PreCompact and SessionEnd
• The Node script detects platform and tries python3 / python / py in the right order for each OS
• Claude Code guarantees Node.js is available (it's a Node.js app), so this is safer than shell-based fallback
• Verifies the Python version is 3.x before using it
• Clear error reporting with issue tracker URL on failure

Also changed:

• Marketplace renamed from dazzle-claude-plugins to dazzle-claude-session-backup to avoid conflict with the session-logger marketplace of the same name

This issue's core request (plugin-based hook delivery) has been fully addressed. Leaving open as tracking for any future hook reliability fixes.

Related

• Similar fix is still needed upstream in claude-session-logger (issue #19 in that repo)