@wuyuchentr/npm-unused-deps

Find unused dependencies in package.json — lighter alternative to depcheck. Scans imports, scripts, and config references.

Usage

npx npm-unused-deps
# → ["lodash","moment"]

npx npm-unused-deps --verbose
# → [{ "name": "lodash", "type": "dependency", "files": [] }]

npx npm-unused-deps /path/to/project

Options

| Flag | Description | |------|-------------| | --verbose, -v | Show detailed output with dep type and references | | <path> | Project directory (default: current dir) |

Exit codes

• 0 — no unused deps
• 1 — unused deps found

How it works

1. Reads package.json — collects all dependencies and devDependencies
2. Scans source files — finds import, require(), import(), export from in .js, .ts, .jsx, .tsx, .vue, .svelte, .mjs
3. Checks implicit usage — looks for references in scripts, config fields (eslintConfig, babel, jest, etc.), and node_modules/.bin
4. Filters related types — @types/foo is excluded if foo is used
5. Returns unused names as a JSON array