mise outdated
- Usage:
mise outdated [FLAGS] [TOOL@VERSION]… - Effect: read-only
- Source code:
src/cli/outdated.rs
Shows outdated tool versions
See mise upgrade to upgrade these versions.
Arguments
[TOOL@VERSION]…— Tool(s) to show outdated versions for e.g.: node@20 python@3.10 If not specified, all tools in global and local configs will be shown
Flags
-b --bump— Compares against the latest versions available, not what matches the current configFor example, if you have
node = "20"in your config by defaultmise outdatedwill only show other 20.x versions, not 21.x or 22.x versions.Using this flag, if there are 21.x or newer versions it will display those instead of 20.x.
-J --json— Output in JSON format--inactive— Show outdated tools including installed-but-inactive tools not present in the current configBy default,
mise outdatedonly shows tools that come from the current config.--local— Only show outdated tools defined in local config filesThis 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 --monorepois not implemented yet.--no-header— Don't show table header-h --help— Print help
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.
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