claude-stuff

A collection of Claude Code hooks and utilities.

Hooks

version-check — "What's New" on Session Start

A SessionStart hook that detects when Claude Code has updated and shows you a summary of what changed.

How it works:

1. On each session start, compares claude --version against a stored version
2. If the version changed, fetches the changelog from GitHub and extracts entries between old → new
3. Injects the changelog into session context and asks Claude to summarize the top 5 highlights
4. On same version, exits silently (zero overhead)

Features:

• First run just records the version — no changelog dump
• 40-line output cap prevents multi-version jumps from flooding context
• curl --max-time 5 caps worst-case network latency
• All errors fail gracefully (exit 0) — never blocks session start
• Version file updated after output, so you see the changelog exactly once

Install

1. Copy the script:

mkdir -p ~/.claude/hooks
cp hooks/version-check.sh ~/.claude/hooks/version-check.sh
chmod +x ~/.claude/hooks/version-check.sh

2. Add the hook to ~/.claude/settings.json:

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "bash /Users/YOUR_USERNAME/.claude/hooks/version-check.sh",
            "timeout": 10
          }
        ]
      }
    ]
  }
}

Note: Use the full absolute path — ~ expansion may not work in settings.json.

3. Start a new Claude Code session. On first run it will record your current version. Next time Claude Code updates, you'll see a summary of what's new.