mise ls

• Usage: mise ls [FLAGS] [INSTALLED_TOOL]…
• Aliases: list
• Effect: read-only
• Source code: src/cli/ls.rs

List installed and active tool versions

Lists the tools mise knows about: versions that are installed, and versions requested by a config file (active) whether or not they are installed. Each row shows the tool, the version (marked (missing) when it is not installed), the config file that requests it, and the request as written.

Arguments

• [INSTALLED_TOOL]… — Only show these tools

Flags

• --truncate — Truncate long terminal output to fit the available width

  Default: true

• -b --backend <BACKEND> — Only show tools from this backend, such as aqua, cargo, core, or go

  Registry shorthands count as the backend they resolve to, so jq is listed under aqua. Repeat the flag to show several backends.

• -c --current — Only show versions the loaded config files request

• -g --global — Only show versions the global config requests

• -i --installed — Only show installed versions

  Hides requested versions that are not installed.

• --grouped — List tools in a separate section for each backend

  Cannot be combined with --json; use --backend to filter JSON output.

• -J --json — Output in JSON format

• -l --local — Only show versions the local config requests

• -m --missing — Only show requested versions that are not installed

• --all-sources — Show requests from every config file mise has seen, not only loaded ones

  mise tracks the config files it loads so mise prune keeps the versions they use.

• --monorepo — Also list tools from every config root in [monorepo].config_roots

  Requires monorepo_root = true and an explicit config_roots list in the monorepo root's config. Uses the active MISE_ENV.

  Environment Variable: MISE_MONOREPO

• --no-header — Do not print the header row

• --outdated — Show whether each version is outdated

• --prefix <PREFIX> — Only show versions starting with PREFIX (requires a tool argument)

• --prunable — List only tools that can be pruned with mise prune

• -h --help — Print help

Examples

Show installed versions and the requests from the loaded config files

mise ls

Show only versions the loaded config files request

mise ls --current

Find requested versions that are not installed

mise ls --missing

Machine-readable output: an object keyed by tool name

mise ls --json

With a tool argument, JSON output is an array of its version records

mise ls node --json

Include requests from every config file mise has seen

mise ls --all-sources

Show only tools from the go or cargo backends

mise ls --backend go --backend cargo

List tools in a separate section for each backend

mise ls --grouped

Related documentation

• Development tools.
• All commands.
• Global flags and argument syntax.