npm-deprecated-check

The tool scans a project’s package.json and lockfile to identify any dependencies that have been marked as deprecated, using the version ranges defined in the project. It can operate on the current workspace, global packages, or a single specified package, and it reports the minimum Node.js version required by the resolved dependencies. When the running Node version is past its End‑Of‑Life or does not satisfy the calculated requirements, the tool suggests compatible alternative versions or indicates that the project’s engines.node field should be updated.

In addition to deprecation detection, the CLI can query OpenAI to recommend replacement packages, and it provides both concise and verbose output modes. The verbose mode separates production and development requirements, shows which package determines each minimum version, and displays detailed validation messages. Options allow ignoring specific packages, failing fast on deprecation, and deep inspection for monorepos.

The command line interface is available globally after installation, supports configurable registry URLs, and works with npm, Yarn, and pnpm managers. It requires Node 18 or newer and includes flags for OpenAI API keys, model selection, and custom base URLs.