docs/cli/ls.md
mise lsmise ls [FLAGS] [INSTALLED_TOOL]…listsrc/cli/ls.rsList installed and active tool versions
This command lists tools that mise "knows about". These may be tools that are currently installed, or those that are in a config file (active) but may or may not be installed.
It's a useful command to get the current state of your tools.
[INSTALLED_TOOL]…Only show tool versions from [TOOL]
-c --currentOnly show tool versions currently specified in a mise.toml
-g --globalOnly show tool versions currently specified in the global mise.toml
-i --installedOnly show tool versions that are installed (Hides tools defined in mise.toml but not installed)
-J --jsonOutput in JSON format
-l --localOnly show tool versions currently specified in the local mise.toml
-m --missingDisplay missing tool versions
--all-sourcesDisplay all tracked config sources for tools
--no-headerDon't display headers
--outdatedDisplay whether a version is outdated
--prefix <PREFIX>Display versions matching this prefix
--prunableList only tools that can be pruned with mise prune
Examples:
$ mise ls
node 20.0.0 ~/src/myapp/.tool-versions latest
python 3.11.0 ~/.tool-versions 3.10
python 3.10.0
$ mise ls --current
node 20.0.0 ~/src/myapp/.tool-versions 20
python 3.11.0 ~/.tool-versions 3.11.0
$ mise ls --json
{
"node": [
{
"version": "20.0.0",
"install_path": "/Users/jdx/.mise/installs/node/20.0.0",
"source": {
"type": "mise.toml",
"path": "/Users/jdx/mise.toml"
}
}
],
"python": [...]
}
$ mise ls --all-sources
node 20.0.0 ~/src/myapp/mise.toml 20
~/.config/mise/config.toml latest