Back to Mise

`mise outdated`

docs/cli/outdated.md

2026.9.22.3 KB
Original Source
<!-- @generated by usage-cli from usage spec -->

mise outdated

  • Usage: mise outdated [FLAGS] [TOOL@VERSION]…
  • Effect: read-only
  • Source code: src/cli/outdated.rs

Show outdated tool versions

See mise upgrade to upgrade these versions.

Arguments

  • [TOOL@VERSION]… — Tool(s) to show outdated versions for e.g.: node@20 [email protected] If not specified, all tools in global and local configs will be shown

Flags

  • -b --bump — Compare against the latest versions available, not just those matching the current config

    For example, with node = "20" in your config, mise outdated normally only reports newer 20.x versions. With this flag it reports the newest version overall, such as 22.x.

  • -J --json — Output in JSON format

  • --inactive — Show outdated tools including installed-but-inactive tools not present in the current config

    By default, mise outdated only shows tools that come from the current config.

  • --local — Only show outdated tools defined in local config files

    This will only show tools that are defined in project-local mise.toml and will skip tools defined in the global config (~/.config/mise/config.toml).

  • --monorepo — Placeholder for future monorepo outdated checks; mise outdated --monorepo is not implemented yet.

  • --no-header — Don't show table header

  • -h --help — Print help

Examples

mise outdated
Plugin  Requested  Current  Latest
python  3.11       3.11.0   3.11.1
node    20         20.0.0   20.1.0
mise outdated node
Plugin  Requested  Current  Latest
node    20         20.0.0   20.1.0
mise outdated --json
{"python": {"requested": "3.11", "current": "3.11.0", "latest": "3.11.1"}, ...}
mise outdated --local
Plugin  Requested  Current  Latest
node    20         20.0.0   20.1.0

Deprecation:

The -l shorthand for --bump is deprecated and will be removed in mise 2027.8.5. After removal, -l will become shorthand for --local. Use -b or --bump instead.

<!-- generated reference navigation -->