claudelint

Appearance

plugin-hook-missing-plugin-root ​

Plugin hooks must use ${CLAUDE_PLUGIN_ROOT} when referencing scripts to ensure portability

Error

Rule Details ​

Plugin hooks that reference script files via relative paths (e.g., ./scripts/lint.sh) will break when the plugin is installed in a different location. This rule ensures that hook commands use the ${CLAUDE_PLUGIN_ROOT} variable to form absolute paths that resolve correctly regardless of where the plugin is installed. Both inline hooks and hooks path references are checked.

Incorrect ​

Hook using a relative script path without $

json
{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "My plugin",
  "hooks": {
    "PostToolUse": [
      {
        "command": "./scripts/post-tool.sh",
        "matcher": "Write"
      }
    ]
  }
}

Correct ​

Hook using ${CLAUDE_PLUGIN_ROOT} for the script path

json
{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "My plugin",
  "hooks": {
    "PostToolUse": [
      {
        "command": "${CLAUDE_PLUGIN_ROOT}/scripts/post-tool.sh",
        "matcher": "Write"
      }
    ]
  }
}

How To Fix ​

Replace relative script paths in hook commands with paths that start with ${CLAUDE_PLUGIN_ROOT}. For example, change "./scripts/lint.sh" to "${CLAUDE_PLUGIN_ROOT}/scripts/lint.sh".

Options ​

This rule does not have any configuration options.

Resources ​

Version ​

Available since: v0.2.0