Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including @oclif/plugin-warn-if-update-available with all npm packages installed. Try it out:

@oclif/plugin-warn-if-update-available lists no main file and has no index.js, so it can't be directly required. If this is a mistake, please let us know. It may however contain internal files that you can require manually:

// require("@oclif/plugin-warn-if-update-available/[??]")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

@oclif/plugin-warn-if-update-available v1.7.0

warns if there is a newer version of CLI released


warns if there is a newer version of CLI released

Version CircleCI Appveyor CI Codecov Downloads/week License

* [What is this?](#what-is-this) * [How it works](#how-it-works) * [Installation](#installation) * [Configuration](#configuration)

What is this?

This plugin shows a warning message if a user is running an out of date CLI.


How it works

This checks the version against the npm registry asynchronously in a forked process, at most once per 7 days. It then saves a version file to the cache directory that will enable the warning. The upside of this method is that it won't block a user while they're using your CLI—the downside is that it will only display after running a command that fetches the new version.


Add the plugin to your project with yarn add @oclif/plugin-warn-if-update-available, then add it to the package.json of the oclif CLI:

  "name": "mycli",
  "version": "0.0.0",
  // ...
  "oclif": {
    "plugins": ["@oclif/plugin-help", "@oclif/plugin-warn-if-update-available"]


In package.json, set oclif['warn-if-update-available'] to an object with any of the following configuration properties:

  • timeoutInDays - Duration between update checks. Defaults to 60.
  • message - Customize update message.
  • registry - URL of registry. Defaults to the public npm registry:
  • authorization - Authorization header value for registries that require auth.

Example configuration

  "oclif": {
    "plugins": [
    "warn-if-update-available": {
      "timeoutInDays": 7,
      "message": "<%= %> update available from <%= chalk.greenBright(config.version) %> to <%= chalk.greenBright(latest) %>.",
      "registry": "",
      "authorization": "Basic <SOME READ ONLY AUTH TOKEN>"
RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free