Checks if a newer version is available for command line interfaces

Usage no npm install needed!

<script type="module">
  import checkKit from '';



NPM Version NPM Downloads Deps Dev Deps

Checks if a newer version is available for command line interfaces.

It is designed to be extremely easy to use and for CLI's that want to be in control.

What check-kit does:

  • Checks if there is a new version available
  • Checks version for a specific dist tag
  • Fetches latest version from npm based on time interval
  • Persists the update metadata
  • Supports HTTP proxies

What check-kit does not do:

  • Display a message when a new version is available, that's up to you how you want it formatted


npm install check-kit --save


Basic usage:

import check from 'check-kit';

(async () => {
    const { current, distTag, name, latest, updateAvailable } = await check();

    console.log(`Current version of package ${name} is ${current}`);

    if (updateAvailable) {
        console.log(`There is a new version available! ${current} -> ${latest}`);
    } else {
        console.log(`Version ${current} is the latest`);

If you know where the package.json is, you can pass it in:

const result = await check({
    pkg: require('./package.json')

By default, check-kit will store update metadata in /tmp/check-kit directory. You can override the directory, but not the metadata filename, by passing in the metadata directory:

const result = await check({
    metaDir: `${os.homedir()}/myapp/update`


async check(opts)

Checks if the specified package has a newer version available.

opts and all options are optional.

Option Type Default Description
opts.applyOwner Boolean true When true, determines the owner of the closest existing parent directory and apply the owner to the file and any newly created directories.
opts.caFile String A path to a PEM-formatted certificate authority bundle.
opts.certFile String A path to a client cert file used for authentication.
opts.checkInterval Number 3600000 The amount of time in milliseconds before checking for an update. Defaults to 1 hour.
opts.cwd String "." The current working directory used to locate the package.json if opts.pkg is not specified.
opts.distTag String "latest" The tag to check for the latest version.
opts.force Boolean false Forces an update check.
opts.keyFile String A path to a private key file used for authentication.
opts.metaDir String "/tmp/check-kit/" The directory to store package update information. The filename is derived by the package name and the dist tag.
opts.pkg Object | String The parsed package.json, path to the package.json file, or falsey and it will scan parent directories looking for a package.json.
opts.proxy String A proxy server URL. Can be http or https.
opts.registryUrl String The npm registry URL. By default, it will autodetect the URL based on the package name/scope.
opts.strictSSL Boolean true When falsey, disables TLS/SSL certificate validation for both https requests and https proxy servers.
opts.timeout Number 1000 The number of milliseconds to wait to query npm before timing out.

Returns a Promise that resolves the following:

Property Type Description
current String The current version from the package.json.
distTag String The dist tag used to check the version.
lastCheck Number The timestamp the last check occurred.
latest String | null The latest version returned from the registry or null if the package is not found.
name String The package name.
updateAvailable Boolean Value is true if a new version is available.

Metadata file

The metadata file contains information about the package and whether an update is available based on the last check.

You can override the directory where the metadata file is stored, but you cannot override the metadata filename. The filename is derived from the package name and the distribution tag. For example, the package @foo/bar would resolve the filename @foo-bar-latest.json.


check-kit update-notifier update-check
Version 1.7.1 5.1.0 1.5.4
Default check interval 1 hour 24 hours 1 hour
Update check method Async/await Subprocess Async/await
Notify of updates immediately :white_check_mark: :x: :white_check_mark:
Persist update available :white_check_mark: :white_check_mark: :white_check_mark:
User-defined persistance directory :white_check_mark: :x: :x:
Specify dist tag :white_check_mark: :white_check_mark: :white_check_mark:
Specify package.json as object :white_check_mark: :white_check_mark: :white_check_mark:
Specify package.json as path :white_check_mark: :x: :x:
Automatically find package.json :white_check_mark: :x: :x:
HTTP proxy support :white_check_mark: :x: :x:
Force check for updates :white_check_mark: :x: :x:
Automatic registry URL discovery :white_check_mark: :white_check_mark: :white_check_mark:
Custom registry URL :white_check_mark: :x: :x:
Registry auth token support :white_check_mark: :white_check_mark: :white_check_mark:
Continuous integration check skip :white_check_mark: :white_check_mark: :x:
NODE_ENV=test check skip :white_check_mark: :white_check_mark: :x:
NO_UPDATE_NOTIFIER=1 check skip :white_check_mark: :white_check_mark: :x:
Graceful offline support :white_check_mark: :white_check_mark: :x:
Apply correct owner when sudo :white_check_mark: :x: :x:
Type of semver update label :x: :white_check_mark: :x:
Renders update available message :x: :white_check_mark: :x:
Persisted opt-out setting :x: :white_check_mark: :x:
License Apache 2 BSD 2-clause MIT


This project is open source under the Apache Public License v2 and is developed by Axway, Inc and the community. Please read the LICENSE file included in this distribution for more information.