mise-en-place

Appearance

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.

Arguments ​

  • [INSTALLED_TOOL]… — Only show tool versions from [TOOL]

Flags ​

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

    Default: true

  • -b --backend <BACKEND> — Only show tools from this backend, e.g. aqua, cargo, core, 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 tool versions currently specified in a mise.toml

  • -g --global — Only show tool versions currently specified in the global mise.toml

  • -i --installed — Only show tool versions that are installed (Hides tools defined in mise.toml but 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 tool versions currently specified in the local mise.toml

  • -m --missing — Display missing tool versions

  • --all-sources — Display all tracked config sources for tools

  • --monorepo — List tools from every [monorepo].config_roots config root

    Uses the active MISE_ENV and requires monorepo_root = true plus explicit [monorepo].config_roots in the monorepo root config.

    Environment Variable: MISE_MONOREPO

  • --no-header — Don't display headers

  • --outdated — Display whether a version is outdated

  • --prefix <PREFIX> — Display versions matching this prefix

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

  • -h --help — Print help

Examples ​

Show installed versions and requests from active configuration

mise ls

Show only versions requested by the current configuration

mise ls --current

Find configured versions that need installation

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 references from every tracked configuration file

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
MIT LicenseCopyright © 2026jdx.dev