mise — cheat sheet
A one-page lookup for the commands and flags used across this course. Grouped by task; the course
pages cover the why behind each one — this page is just the what.
Setup
| Task |
Command |
| Install (macOS) |
brew install mise |
| Install (Linux/WSL) |
curl https://mise.run \| sh |
| Activate (zsh) |
eval "$(mise activate zsh)" in ~/.zshrc |
| Activate (bash) |
eval "$(mise activate bash)" in ~/.bashrc |
| Activate (fish) |
mise activate fish \| source |
| Health check |
mise doctor |
| Version |
mise --version |
Config & precedence
| Task |
Command |
| Trust the current dir's config |
mise trust |
| Trust every config under cwd |
mise trust --all |
| Revoke trust |
mise trust --untrust |
| Show every config file loaded here, in order |
mise config ls |
| Show resolved tool versions |
mise current |
| Task |
Command |
| Add/update a tool in the nearest config |
mise use node@20.11.0 |
| Add to the global config |
mise use -g rust@latest |
| Remove from config |
mise use --rm node |
| Install everything in the config |
mise install |
| Install one version explicitly |
mise install node@20.11.0 |
| Upgrade every tool to its matching latest |
mise upgrade |
| Upgrade one tool |
mise upgrade node |
| Remove one installed version |
mise uninstall node@20.10.0 |
| Delete versions not referenced by any config |
mise prune |
| List installed + active versions |
mise ls --current |
| Discover available versions |
mise ls-remote node 20 |
| Which backend a short name resolves to |
mise registry node |
Version specifiers
| Specifier |
Means |
Use when |
"20.11.0" |
Exact version |
Always, in shared configs |
"20" / "20.11" |
Latest matching patch at install time |
Personal tools only |
"latest" |
Latest version at install time |
Personal global tools |
"lts" |
Latest LTS (node, java) |
Personal use |
"system" |
Use the system's existing version |
Tool must come from system packages |
"ref:main" |
Build from a git ref |
Tracking unreleased fixes |
Env
| Task |
Command |
| Print resolved env in shell-eval form |
mise env |
| Apply it to the current shell |
eval "$(mise env)" |
| Load a dotenv file |
_.file = ".env" in [env] |
| Prepend to PATH |
_.path = ["./bin"] in [env] |
| Auto-activate a Python venv |
_.python.venv = ".venv" in [env] |
| Switch environment layer, one-off |
MISE_ENV=production mise run deploy |
| Switch environment layer, session |
export MISE_ENV=staging |
Tasks
| Task |
Command |
| List every task with its description |
mise tasks |
| Run one task |
mise run lint |
Run a task and its depends chain |
mise run test |
| Run a quoted/namespaced task |
mise run db:reset |
| Run multiple, in parallel where possible |
mise run lint ::: test |
| Run a task with args |
mise run release 0.2.0 |
| Get a file task's auto-generated help |
mise run release --help |
Exec (no activation)
| Task |
Command |
| Run a command with mise's env applied, without activating |
mise exec -- node script.js |
| Run against a specific version |
mise exec node@20.11.0 -- node --version |
Diagnosis
| Task |
Command |
| Config paths, trust state, activation health |
mise doctor |
| Verbose install |
mise --debug install |
| All settings + values |
mise settings |
How this connects
The config-precedence page covers how mise.toml / mise.local.toml / .tool-versions / global config
layer together, the tasks page covers the task DAG and file-task conventions, and the environments &
backends page covers MISE_ENV layering and the nine tool backends.