# finboxio-npm-check > Check for outdated, incorrect, and unused dependencies. Latest version **4.1.4** (published 2016-03-18) · MIT license · 0 weekly downloads ## Install ```sh npm install finboxio-npm-check pnpm add finboxio-npm-check yarn add finboxio-npm-check bun add finboxio-npm-check ``` Provides the command `npm-check`. ## Health **Score 15/100 (F)** — status: abandoned. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 4.1.4 | | Published | 2016-03-18 | | First published | 2016-03-18 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 18 | | Known vulnerabilities | 0 (+6 in 1 direct dependencies) | | Install scripts | no | | GitHub stars | 0 | | Author | Dylan Greene | | Maintainers | bdentino | | Keywords | npm, outdated, dependencies, unused, changelog, check, updates, api, interactive, cli, safe, updating, updater, installer, devDependencies | ## Links - npm: https://www.npmjs.com/package/finboxio-npm-check - Repository: https://github.com/finboxio/npm-check - Issues: https://github.com/finboxio/npm-check/issues - npm.io page: https://npm.io/package/finboxio-npm-check ## Dependencies (18) - [q](https://npm.io/package/q.md) ^1.4.1 - [chalk](https://npm.io/package/chalk.md) ^1.1.0 - [giturl](https://npm.io/package/giturl.md) ^1.0.0 - [globby](https://npm.io/package/globby.md) ^3.0.1 - [lodash](https://npm.io/package/lodash.md) ^3.10.0 - [semver](https://npm.io/package/semver.md) ^5.0.1 - [figures](https://npm.io/package/figures.md) ^1.4.0 - [depcheck](https://npm.io/package/depcheck.md) ^0.5.9 - [inquirer](https://npm.io/package/inquirer.md) ^0.11.0 - [commander](https://npm.io/package/commander.md) ^2.9.0 - [cli-cursor](https://npm.io/package/cli-cursor.md) ^1.0.2 - [node-emoji](https://npm.io/package/node-emoji.md) ^1.0.3 - [text-table](https://npm.io/package/text-table.md) ^0.2.0 - [semver-diff](https://npm.io/package/semver-diff.md) ^2.0.0 - [buffered-spawn](https://npm.io/package/buffered-spawn.md) ^1.1.2 - [global-modules](https://npm.io/package/global-modules.md) ^0.2.0 - [update-notifier](https://npm.io/package/update-notifier.md) ^0.5.0 - [finboxio-package-json](https://npm.io/package/finboxio-package-json.md) ^2.3.2 ## Alternatives - [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads - [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads - [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads - [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads - [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads ## Recent versions - 4.1.4 (latest) — 2016-03-18 ## README ## npm-check [![Build Status](http://img.shields.io/travis/dylang/npm-check.svg)](https://travis-ci.org/dylang/npm-check) [![npm-check](http://img.shields.io/npm/dm/npm-check.svg)](https://www.npmjs.org/package/npm-check) > Check for outdated, incorrect, and unused dependencies. npm-check -u ### Features * Tells you what's out of date. * Provides a link to the package's documentation so you can decide if you want the update. * Kindly informs you if a dependency is not being used in your code. * Works on your globally installed packages too, via `-g`. * **Interactive Update** for less typing and fewer typos, via `-u`. * Supports public and private [@scoped/packages](https://docs.npmjs.com/getting-started/scoped-packages). * Supports ES6-style [`import from`](http://exploringjs.com/es6/ch_modules.html) syntax. * Upgrades your modules using your installed version of npm, including the new `npm@3`, so dependencies go where you expect them. * Works the public registry, [private registries](https://www.npmjs.com/onsite), and [Sinopia](https://github.com/rlidwka/sinopia). * Avoids querying npm registries for packages with `private: true` in their package.json. * Emoji in a command-line app, because command-line apps can be fun too. ### On the command line This is how you should use `npm-check`. #### Install ```bash $ npm install -g npm-check ``` #### Use ```bash $ npm-check ``` npm-check The result should look like the screenshot, or something nice when your packages are all up-to-date and in use. #### Options ``` $ npm-check --help Usage: npm-check [options] Options: -h, --help output usage information -V, --version output the version number -u, --update Interactive update. -g, --global Look at global modules. -s, --skip-unused Skip check for unused packages. -p, --production Ignore devDependencies. ``` ![npm-check-u](https://cloud.githubusercontent.com/assets/51505/9569912/8c600cd8-4f48-11e5-8757-9387a7a21316.gif) ##### -u, --update Show an interactive UI for choosing which modules to update. Automatically updates versions referenced in the `package.json`. _Based on recommendations from the `npm` team, `npm-check` only updates using `npm install`, not `npm update`. To avoid using more than one version of `npm` in one directory, `npm-check` will automatically install updated modules using the version of `npm` installed globally._ npm-check -g -u ##### -g, --global Check the versions of your globally installed packages. _Tip: Use `npm-check -u -g` to do a safe interactive update of global modules, including npm itself._ ##### -s, --skip-unused By default `npm-check` will let you know if any of your modules are not being used by looking at `require` statements in your code. This option will skip that check. This is enabled by default when using `global` or `update`. ##### -p, --production By default `npm-check` will look at packages listed as `dependencies` and `devDependencies`. This option will let it ignore outdated and unused checks for packages listed as `devDependencies`. ### API The API is here in case you want to wrap this with your CI toolset. ```js var npmCheck = require('npm-check'); npmCheck(options) .then(result); ``` #### `npmCheck(options)` returns `promise` ##### options ###### global `boolean` * default is `false` Use the globally installed packages. When `true`, the `path` is automatically set. ###### update `boolean` * default is `false` Interactive update. ###### skipUnused `boolean` * default is `false` Skip checking for unused packages. ###### ignoreDev `boolean` * default is `false` Ignore `devDependencies`. ###### path `string` * default is `cwd` Override where `npm-check` checks. #####`result` `object of module names : data` `data` looks like this: About the module * moduleName: name of the module. * homepage: url to the home page. Versions * latest: latest according to the registry. * installed: version in node_modules. * packageJson: version or range in package.json. * devDependency: Is this a devDependency? * usedInScripts: Is this used in the scripts section of package.json? * mismatch: Is the version installed not match the range in package.json? * semverValidRange: Is the package.json range valid? * semverValid: Is the installed version valid semver? * easyUpgrade: Will using npm install upgrade the module? * bump: What kind of bump is required to get the latest, such as patch, minor, major. * unused: Is this module used in the code? ### Inspiration * [npm outdated](https://www.npmjs.org/doc/cli/npm-outdated.html) - awkward output, requires --depth=0 to be grokable. * [david](https://github.com/alanshaw/david) - does not work with private registries. * [update-notifier](https://github.com/yeoman/update-notifier) - for single modules, not everything in package.json. * [depcheck](https://github.com/rumpl/depcheck) - only part of the puzzle. npm-check uses depcheck. ### About the Author Hi! Thanks for checking out this project! My name is **Dylan Greene**. When not overwhelmed with my two young kids I enjoy contributing to the open source community. I'm also a tech lead at [Opower](http://opower.com). [![@dylang](https://img.shields.io/badge/github-dylang-green.svg)](https://github.com/dylang) [![@dylang](https://img.shields.io/badge/twitter-dylang-blue.svg)](https://twitter.com/dylang) Here's some of my other Node projects: | Name | Description | npm Downloads | |---|---|---| | [`grunt‑notify`](https://github.com/dylang/grunt-notify) | Automatic desktop notifications for Grunt errors and warnings using Growl for OS X or Windows, Mountain Lion and Mavericks Notification Center, and Notify-Send. | [![grunt-notify](https://img.shields.io/npm/dm/grunt-notify.svg?style=flat-square)](https://www.npmjs.org/package/grunt-notify) | | [`shortid`](https://github.com/dylang/shortid) | Amazingly short non-sequential url-friendly unique id generator. | [![shortid](https://img.shields.io/npm/dm/shortid.svg?style=flat-square)](https://www.npmjs.org/package/shortid) | | [`rss`](https://github.com/dylang/node-rss) | RSS feed generator. Add RSS feeds to any project. Supports enclosures and GeoRSS. | [![rss](https://img.shields.io/npm/dm/rss.svg?style=flat-square)](https://www.npmjs.org/package/rss) | | [`grunt‑prompt`](https://github.com/dylang/grunt-prompt) | Interactive prompt for your Grunt config using console checkboxes, text input with filtering, password fields. | [![grunt-prompt](https://img.shields.io/npm/dm/grunt-prompt.svg?style=flat-square)](https://www.npmjs.org/package/grunt-prompt) | | [`xml`](https://github.com/dylang/node-xml) | Fast and simple xml generator. Supports attributes, CDATA, etc. Includes tests and examples. | [![xml](https://img.shields.io/npm/dm/xml.svg?style=flat-square)](https://www.npmjs.org/package/xml) | | [`changelog`](https://github.com/dylang/changelog) | Command line tool (and Node module) that generates a changelog in color output, markdown, or json for modules in npmjs.org's registry as well as any public github.com repo. | [![changelog](https://img.shields.io/npm/dm/changelog.svg?style=flat-square)](https://www.npmjs.org/package/changelog) | | [`grunt‑attention`](https://github.com/dylang/grunt-attention) | Display attention-grabbing messages in the terminal | [![grunt-attention](https://img.shields.io/npm/dm/grunt-attention.svg?style=flat-square)](https://www.npmjs.org/package/grunt-attention) | | [`observatory`](https://github.com/dylang/observatory) | Beautiful UI for showing tasks running on the command line. | [![observatory](https://img.shields.io/npm/dm/observatory.svg?style=flat-square)](https://www.npmjs.org/package/observatory) | | [`anthology`](https://github.com/dylang/anthology) | Module information and stats for any @npmjs user | [![anthology](https://img.shields.io/npm/dm/anthology.svg?style=flat-square)](https://www.npmjs.org/package/anthology) | | [`grunt‑cat`](https://github.com/dylang/grunt-cat) | Echo a file to the terminal. Works with text, figlets, ascii art, and full-color ansi. | [![grunt-cat](https://img.shields.io/npm/dm/grunt-cat.svg?style=flat-square)](https://www.npmjs.org/package/grunt-cat) | _This list was generated using [anthology](https://github.com/dylang/anthology)._ ### License Copyright (c) 2015 Dylan Greene, contributors. Released under the [MIT license](https://tldrlegal.com/license/mit-license). Screenshots are [CC BY-SA](http://creativecommons.org/licenses/by-sa/4.0/) (Attribution-ShareAlike). *** _Generated using [grunt-readme](https://github.com/assemble/grunt-readme) with [grunt-templates-dylang](https://github.com/dylang/grunt-templates-dylang) on Sunday, October 11, 2015._ _To make changes to this document look in `/templates/readme/` --- _Source: https://npm.io/package/finboxio-npm-check · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._