handoff

Executes bash commands and modifies files at key Claude session events like startup, tool use, and shutdown.

Defined in hooks/hooks.json

{
  "PreCompact": [
    {
      "hooks": [
        {
          "type": "command",
          "command": "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/pre-compact.sh",
          "timeout": 15,
          "statusMessage": "Auto-saving session state..."
        }
      ],
      "matcher": ""
    }
  ],
  "SessionEnd": [
    {
      "hooks": [
        {
          "type": "command",
          "command": "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/pre-compact.sh",
          "timeout": 10,
          "statusMessage": "Auto-saving session state..."
        }
      ],
      "matcher": "logout|prompt_input_exit|other"
    }
  ],
  "PostToolUse": [
    {
      "hooks": [
        {
          "type": "command",
          "async": true,
          "command": "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/event-capture.sh",
          "timeout": 3,
          "statusMessage": ""
        }
      ],
      "matcher": "Bash|Write|Edit"
    }
  ],
  "SessionStart": [
    {
      "hooks": [
        {
          "type": "command",
          "command": "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/session-start.sh",
          "timeout": 10,
          "statusMessage": "Loading handoff context..."
        }
      ],
      "matcher": "startup|resume"
    },
    {
      "hooks": [
        {
          "type": "command",
          "command": "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/compact-reinject.sh",
          "timeout": 5,
          "statusMessage": "Re-injecting handoff context..."
        }
      ],
      "matcher": "compact"
    },
    {
      "hooks": [
        {
          "type": "command",
          "command": "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/session-clear.sh",
          "timeout": 3,
          "statusMessage": "Resetting context state..."
        }
      ],
      "matcher": "clear"
    }
  ],
  "UserPromptSubmit": [
    {
      "hooks": [
        {
          "type": "command",
          "command": "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/prompt-reminder.sh",
          "timeout": 3,
          "statusMessage": ""
        }
      ],
      "matcher": ""
    }
  ],
  "PostToolUseFailure": [
    {
      "hooks": [
        {
          "type": "command",
          "async": true,
          "command": "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/event-capture.sh",
          "timeout": 3,
          "statusMessage": ""
        }
      ],
      "matcher": "Bash|Write|Edit"
    }
  ]
}

{
  "riskFlags": {
    "touchesBash": true,
    "matchAllTools": false,
    "touchesFileWrites": true
  },
  "typeStats": {
    "command": 8
  },
  "eventStats": {
    "PreCompact": 1,
    "SessionEnd": 1,
    "PostToolUse": 1,
    "SessionStart": 3,
    "UserPromptSubmit": 1,
    "PostToolUseFailure": 1
  },
  "originCounts": {
    "absolutePaths": 0,
    "pluginScripts": 8,
    "projectScripts": 0
  },
  "timeoutStats": {
    "commandsWithoutTimeout": 0
  }
}