@oclif/plugin-update

What is @oclif/plugin-update?

@oclif/plugin-update is a plugin for the Oclif CLI framework that provides functionality for updating CLI applications. It allows developers to easily integrate update commands into their CLI tools, ensuring that users can always have the latest version of the tool.

What are @oclif/plugin-update's main functionalities?

Check for Updates

This feature allows the CLI tool to check for updates. The `UpdateCommand` class from `@oclif/plugin-update` is extended to create a custom update command that can be run to check for updates.

const { Command } = require('@oclif/core');
const { UpdateCommand } = require('@oclif/plugin-update');

class MyUpdateCommand extends UpdateCommand {
  async run() {
    await super.run();
    this.log('Checked for updates!');
  }
}

module.exports = MyUpdateCommand;

Run Update

This feature allows the CLI tool to perform an update. The `UpdateCommand` class is used to run the update process, ensuring that the CLI tool is updated to the latest version.

const { Command } = require('@oclif/core');
const { UpdateCommand } = require('@oclif/plugin-update');

class MyUpdateCommand extends UpdateCommand {
  async run() {
    await super.run();
    this.log('CLI tool updated to the latest version!');
  }
}

module.exports = MyUpdateCommand;

Other packages similar to @oclif/plugin-update

update-notifier

The `update-notifier` package checks for updates of a CLI tool and notifies the user if a new version is available. Unlike `@oclif/plugin-update`, it does not perform the update itself but rather informs the user to update manually.

npm-check-updates

`npm-check-updates` is a package that allows you to find and update outdated npm dependencies. While it is not specifically for CLI tools, it provides similar functionality in terms of checking for and updating dependencies.

yarn-upgrade-all

`yarn-upgrade-all` is a package that upgrades all dependencies for a project using Yarn. It is similar to `@oclif/plugin-update` in that it automates the update process, but it is focused on project dependencies rather than CLI tools.

README

@oclif/plugin-update

• @oclif/plugin-update
• Usage
• Commands
• Contributing

Usage

See https://oclif.io/docs/releasing.html#autoupdater

Configuration

Update Check Interval

You can customize how often the plugin checks for updates by adding the autoupdate.debounce configuration to your package.json:

{
  "oclif": {
    "update": {
      "autoupdate": {
        "debounce": 7
      }
    }
  }
}

The debounce value is the number of days between update checks for all channels. When set, it overrides the default behavior for all channels.

If not configured, the plugin defaults to:

• Stable channel: 14 days
• Other channels: 1 day

Commands

• oclif-example update [CHANNEL]

oclif-example update [CHANNEL]

update the oclif-example CLI

USAGE
  $ oclif-example update [CHANNEL] [--force |  | [-a | -v <value> | -i]] [-b ]

FLAGS
  -a, --available        See available versions.
  -b, --verbose          Show more details about the available versions.
  -i, --interactive      Interactively select version to install. This is ignored if a channel is provided.
  -v, --version=<value>  Install a specific version.
      --force            Force a re-download of the requested version.

DESCRIPTION
  update the oclif-example CLI

EXAMPLES
  Update to the stable channel:

    $ oclif-example update stable

  Update to a specific version:

    $ oclif-example update --version 1.0.0

  Interactively select version:

    $ oclif-example update --interactive

  See available versions:

    $ oclif-example update --available

See code: src/commands/update.ts

Contributing

See contributing guide

Changelog

4.7.4 (2025-08-17)

Bug Fixes

• deps: bump @oclif/table from 0.4.11 to 0.4.12 (#1169) (16f515a)