{"id":25878,"library":"lint-staged-shellcheck","title":"lint-staged-shellcheck","description":"A shim to run shellcheck on staged shell files via lint-staged, supporting shebang detection and filename patterns. Version 0.1.2 (latest). Stable but low activity. Key differentiator: works around lint-staged's lack of shebang-based file matching, allowing shell scripts without .sh extension to be checked. Ignores via .shellcheckignore. Requires shellcheck binary and lint-staged as peer.","status":"active","version":"0.1.2","language":"javascript","source_language":"en","source_url":"https://github.com/ahawkins/lint-staged-shellcheck","tags":["javascript"],"install":[{"cmd":"npm install lint-staged-shellcheck","lang":"bash","label":"npm"},{"cmd":"yarn add lint-staged-shellcheck","lang":"bash","label":"yarn"},{"cmd":"pnpm add lint-staged-shellcheck","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency, requires lint-staged to operate","package":"lint-staged","optional":false}],"imports":[{"note":"This package is a CLI tool, not a JS module. Use via npx or as a lint-staged command.","wrong":"require('lint-staged-shellcheck')","symbol":"lint-staged-shellcheck","correct":"npx lint-staged-shellcheck"},{"note":"The command is added verbatim as a lint-staged task, typically under a '*' glob rule.","wrong":"\"lint-staged-shellcheck --some-flag\"","symbol":"default","correct":"\"lint-staged-shellcheck\""}],"quickstart":{"code":"// package.json\n{\n  \"lint-staged\": {\n    \"*\": [\n      \"lint-staged-shellcheck\"\n    ]\n  }\n}\n\n// Then in terminal:\nnpx lint-staged","lang":"javascript","description":"Configure lint-staged to run lint-staged-shellcheck on all files, which filters shell scripts by shebang or .sh/.bash/.zsh extension."},"warnings":[{"fix":"Install shellcheck: brew install shellcheck (macOS) or apt install shellcheck (Linux).","message":"lint-staged-shellcheck does NOT auto-install shellcheck binary; you must install it separately via brew, apt, etc.","severity":"gotcha","affected_versions":"all"},{"fix":"Ensure lint-staged is configured as the runner.","message":"This package only works as a lint-staged command; it cannot run standalone without lint-staged's staged file context.","severity":"gotcha","affected_versions":"all"},{"fix":"Upgrade Node.js to >= 10.","message":"Node.js versions < 10 are not supported; package uses modern syntax.","severity":"deprecated","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Install shellcheck: brew install shellcheck (macOS) or apt install shellcheck (Linux).","cause":"shellcheck binary not installed on the system.","error":"shellcheck: command not found"},{"fix":"Ensure lint-staged config has a '*' rule that includes 'lint-staged-shellcheck'.","cause":"lint-staged is not passing any files to the command, or the '*' glob is missing.","error":"No staged files found"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}