<!-- @generated by usage-cli from usage spec -->
# `mise outdated`

- **Usage:** `mise outdated [FLAGS] [TOOL@VERSION]…`
- **Effect:** read-only
- **Source code:** [`src/cli/outdated.rs`](https://github.com/jdx/mise/blob/main/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 config

  For example, if you have `node = "20"` in your config by default `mise outdated` will 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 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

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
```
