claudelint

Appearance

settings-file-path-not-found ​

Referenced file path does not exist

Warning

Rule Details ​

This rule validates that file paths in settings.json properties such as apiKeyHelper and outputStyle point to files that actually exist on disk. Missing files will cause runtime errors when Claude Code tries to use them. Paths containing variable expansion syntax (e.g., ${HOME}/...) are skipped since they cannot be resolved statically.

Incorrect ​

Settings referencing a non-existent script

json
{
  "apiKeyHelper": "/scripts/get-api-key.sh",
  "outputStyle": "./styles/missing-style.md"
}

Correct ​

Settings referencing existing files

json
{
  "apiKeyHelper": "./scripts/get-api-key.sh",
  "outputStyle": ".claude/styles/concise.md"
}

Settings using variable expansion (skipped)

json
{
  "apiKeyHelper": "${HOME}/.config/claude/api-key-helper.sh"
}

How To Fix ​

Verify that the file paths in settings.json are correct and the files exist. Check for typos in the path, ensure the file has been created, and confirm the path is relative to the correct base directory.

Options ​

This rule does not have any configuration options.

Resources ​

Version ​

Available since: v0.2.0