MISE(1) General Commands Manual MISE(1) (NAME) mise - (CLI) (SYNOPSIS) mise [OPTIONS] [] [] ... [] ... [COMMAND] (DESCRIPTION) mise . https://github.com/jdx/mise (OPTIONS) -c, --continue-on-error -C, --cd -E, --env `mise..toml` -f, --force -j, --jobs [: 8] : MISE_JOBS -n, --dry-run -P, --profile () -q, --quiet : MISE_QUIET -s, --shell -t, --tool () mise.toml : node@20 python@3.10 -v, --verbose ( -vv ) -V, --version -y, --yes (yes) --debug debug --log-level --no-config `MISE_NO_CONFIG=1` --no-env `MISE_NO_ENV=1` --no-hooks (hooks) `MISE_NO_HOOKS=1` --no-timings `MISE_TASK_TIMINGS=0` --output --raw / stdin/stdout/stderr --locked (URLs) . API GitHub aqua . MISE_LOCKED=1 settings.locked=true --silent mise --timings `MISE_TASK_TIMINGS=1` --trace trace -h, --help .SH " (ARGUMENTS)" () . `mise tasks run `. (COMMANDS) activate mise tool-alias (alias) . : alias, aliases tool-alias get tool-alias ls : list tool-alias set /backend : add, create tool-alias unset /backend : rm, remove, delete, del backends backend : b, backend, backend-list backends ls backend : list bin-paths (bin) bootstrap : bs bootstrap accounts `[bootstrap.users]` `[bootstrap.groups]` bootstrap accounts apply bootstrap accounts status bootstrap compose Docker Compose `[bootstrap.compose]` bootstrap compose apply Docker Compose bootstrap compose status Docker Compose bootstrap dotfiles (dotfiles) `[dotfiles]` bootstrap dotfiles add `[dotfiles]` bootstrap dotfiles apply `[dotfiles]` bootstrap dotfiles diff `[dotfiles]` bootstrap dotfiles edit bootstrap dotfiles status `[dotfiles]` : ls bootstrap dotfiles unapply `[dotfiles]` bootstrap files `[bootstrap.files]` `[bootstrap.directories]` bootstrap files apply bootstrap files status bootstrap firewall `[bootstrap.linux.firewall]` bootstrap firewall apply bootstrap firewall status bootstrap linux `[bootstrap.linux]` bootstrap linux systemd-units systemd `[bootstrap.linux.systemd.units]` : systemd bootstrap linux systemd-units apply bootstrap linux systemd-units status bootstrap macos macOS `[bootstrap.macos]` bootstrap macos defaults defaults macOS `[bootstrap.macos.defaults]` bootstrap macos defaults apply bootstrap macos defaults status bootstrap macos launchd-agents LaunchAgents macOS `[bootstrap.macos.launchd.agents]` : launchd bootstrap macos launchd-agents apply bootstrap macos launchd-agents status bootstrap mise-shell-activate mise `[bootstrap.mise_shell_activate]` : shell bootstrap mise-shell-activate apply bootstrap mise-shell-activate status bootstrap packages `[bootstrap.packages]` bootstrap packages apply `[bootstrap.packages]` : i, install bootstrap packages brew tap Homebrew bootstrap packages brew tap Homebrew tap [bootstrap.brew.taps] bootstrap packages brew untap Homebrew tap [bootstrap.brew.taps] : remove, rm bootstrap packages import `[bootstrap.packages]` bootstrap packages prune `[bootstrap.packages]` bootstrap packages status `[bootstrap.packages]` : ls bootstrap packages upgrade bootstrap `[bootstrap.packages]` : up bootstrap packages use bootstrap [bootstrap.packages] : u bootstrap plan bootstrap bootstrap plugins `[bootstrap.plugins]` bootstrap plugins apply bootstrap plugins status bootstrap remote (bootstrap) OpenSSH bootstrap repos git `[bootstrap.repos]` bootstrap repos apply bootstrap repos exec bootstrap repos status bootstrap repos update bootstrap secrets bootstrap bootstrap secrets status bootstrap bootstrap services `[bootstrap.services]` bootstrap services apply bootstrap services status bootstrap status bootstrap : ls bootstrap user bootstrap `[bootstrap.user]` bootstrap user apply bootstrap user status cache mise cache clear mise : c, clean cache path : dir cache prune mise : p cache task completion : complete, completions config : cfg, toml config get mise.toml config ls : list config set mise.toml deactivate mise doctor mise : dr doctor path PATH mise : paths en mise env mise : e exec () : x fmt mise.toml generate : gen, g generate config mise.toml generate devcontainer devcontainer mise generate git-pre-commit (hook) git pre-commit : pre-commit generate github-action (workflow) GitHub Action generate install-script mise.TP generate task-docs generate task-stubs shims mise generate tool-stub tool stub HTTP implode CLI mise edit mise.toml install : i install-into latest link (symlink) mise : ln lock URL lockfile ls : list ls-remote runtime . : list-all, list-remote mcp Model Context Protocol (MCP) oci [] OCI mise.toml oci build [] OCI mise.toml oci push [] OCI (push) oci run [] OCI mise.toml outdated patrons Patron mise plugins : p, plugin, plugin-list plugins install : i, a, add plugins link (symlink) mise : ln plugins ls : list plugins ls-remote : list-remote, list-all plugins uninstall : remove, rm plugins update : up, upgrade deps [] : dep, prepare deps add deps install deps remove prune registry reshim shims bin . run () : r search self-update mise. set mise.toml : ev, env-vars settings settings add settings get settings ls : list settings set / : create settings unset : rm, remove, delete, del shell . : sh shell-alias . shell-alias get shell-alias ls : list shell-alias set : add, create shell-alias unset : rm, remove, delete, del sponsors mise jdx.dev sync mise sync node mise sync python mise sync ruby ruby mise tasks : t, task tasks add tasks deps tasks edit $EDITOR tasks graph [] tasks info tasks ls tasks run () : r tasks validate test-tool token mise token forgejo Forgejo mise token github GitHub mise token gitlab GitLab mise tool tool-stub (stub) trust uninstall unset () . untrust unuse mise.toml : rm, remove upgrade : up use mise.toml. : u version mise : v watch () : w where which (bin) ..SH "MISE ACTIVATE" mise rc (login shell) . . ( : ~/.zshrc ~/.zprofile ~/.zshenv ~/.bashrc ~/.bash_profile ~/.profile ~/.config/fish/config.fish $PROFILE powershell) : echo 'eval "$(mise activate zsh)"' >> ~/.zshrc "mise" PATH . : echo 'eval "$(/path/to/mise activate zsh)"' >> ~/.zshrc `status` . : mise activate [OPTIONS] [] : -q, --quiet -s, --shell --no-hook-env hook-env mise . `eval "$(mise activate --no-hook-env)"` `mise hook-env` stdout . `mise hook-env --trace` hook-env . --shims shim PATH : PATH="$HOME/.local/share/mise/shims:$PATH" `mise activate --shims` `mise activate` . --status "mise: @" -h, --help : MISE TOOL-ALIAS . : mise tool-alias [OPTIONS] [COMMAND] : -p, --tool --no-header -h, --help MISE TOOL-ALIAS GET tool_alias. ~/.config/mise/config.toml : mise tool-alias get [OPTIONS] : -h, --help : .SH "MISE TOOL-ALIAS LS" . `bin/list-aliases` . `~/.config/mise/config.toml` : [tool_alias.node.versions] lts = "22.0.0" : mise tool-alias ls [OPTIONS] [] : --no-header -h, --help : MISE TOOL-ALIAS SET /backend ~/.config/mise/config.toml : mise tool-alias set [OPTIONS] [] : -h, --help : /backend MISE TOOL-ALIAS UNSET /backend ~/.config/mise/config.toml : mise tool-alias unset [OPTIONS] [] : -h, --help : /backend MISE BACKENDS backend : mise backends [OPTIONS] [COMMAND] : -h, --help MISE BACKENDS LS backend (built-in) : mise backends ls [OPTIONS] : -h, --help .SH "MISE BIN-PATHS" bin : mise bin-paths [OPTIONS] [] ... : --bin-names bin -J, --json JSON ( --bin-names ) -h, --help : () : ruby@3 MISE BOOTSTRAP (bootstrap) : 0. `mise bootstrap accounts apply` -- `[bootstrap.users]` `[bootstrap.groups]` () 1. `mise bootstrap plugins apply` -- `[bootstrap.plugins]` 1.7. `[bootstrap.hooks.pre-packages]` -- 2. built-in-manager `[bootstrap.packages]` 3. `mise bootstrap files apply` -- `[bootstrap.files]` `[bootstrap.directories]` 4. `mise bootstrap services apply` -- systemd `[bootstrap.services]` () 5. `mise bootstrap firewall apply` -- `[bootstrap.linux.firewall]` () 6. `mise bootstrap compose apply` -- Docker Compose `[bootstrap.compose]` 7. `mise bootstrap repos apply` -- / `[bootstrap.repos]` `pre-repos`/`post-repos` 8. `mise bootstrap dotfiles apply` -- dotfiles `[dotfiles]` `pre-dotfiles`/`post-dotfiles` 9. `mise bootstrap mise-shell-activate apply` -- `[bootstrap.mise_shell_activate]` 10. `mise bootstrap macos defaults apply` -- `[bootstrap.macos.defaults]` ( macOS) `pre-defaults`/`post-defaults` 11. `mise bootstrap macos launchd-agents apply` -- / `[bootstrap.macos.launchd.agents]` 12. `mise bootstrap linux systemd-units apply` -- / `[bootstrap.linux.systemd.units]` 13. `mise bootstrap user apply` -- `[bootstrap.user].login_shell` () `pre-user`/`post-user` 14. `mise install` -- `[tools]` `pre-tools`/`post-tools` package-plugin `[bootstrap.packages]` `[bootstrap.hooks.post-packages]` 15. `mise run bootstrap` -- `bootstrap` 16. `[bootstrap.hooks.final]` -- (declarative) -- . `bootstrap` (idempotent) . ( ) -- PATH . `--skip ` `--only ` . . : mise bootstrap [OPTIONS] [COMMAND] : --from git (bootstrap) --from-dir --from -n, --dry-run -y, --yes --skip-dirty --force-dotfiles dotfile --only (bootstrap) . `--skip` . --prompt-secrets --skip (bootstrap) . --update -h, --help .SH "MISE BOOTSTRAP ACCOUNTS" `[bootstrap.users]` `[bootstrap.groups]` : mise bootstrap accounts [OPTIONS] : -h, --help MISE BOOTSTRAP ACCOUNTS APPLY : mise bootstrap accounts apply [OPTIONS] : -n, --dry-run -y, --yes -h, --help MISE BOOTSTRAP ACCOUNTS STATUS : mise bootstrap accounts status [OPTIONS] : -J, --json JSON --missing -h, --help MISE BOOTSTRAP COMPOSE Docker Compose `[bootstrap.compose]` : mise bootstrap compose [OPTIONS] : -h, --help MISE BOOTSTRAP COMPOSE APPLY Docker Compose : mise bootstrap compose apply [OPTIONS] : -n, --dry-run -y, --yes -h, --help MISE BOOTSTRAP COMPOSE STATUS Docker Compose : mise bootstrap compose status [OPTIONS] : -J, --json JSON --missing Compose -h, --help .SH "MISE BOOTSTRAP DOTFILES" dotfile `[dotfiles]` : mise bootstrap dotfiles [OPTIONS] : -h, --help MISE BOOTSTRAP DOTFILES ADD dotfile `[dotfiles]` . `[dotfiles]` `dotfiles.root` `--source` . : mise bootstrap dotfiles add [OPTIONS] [] ... : --changed copy -f, --force -g, --global (global) -l, --local (local) -m, --mode dotfile -n, --dry-run / --no-apply -p, --path -s, --source -y, --yes -h, --help : MISE BOOTSTRAP DOTFILES APPLY dotfile `[dotfiles]` (whole-file) . (symlink) (render) . mise . : mise bootstrap dotfiles apply [OPTIONS] [] ... : -f, --force dotfile -n, --dry-run -y, --yes -h, --help : .SH "MISE BOOTSTRAP DOTFILES DIFF" `[dotfiles]` : mise bootstrap dotfiles diff [OPTIONS] [] ... : -h, --help : MISE BOOTSTRAP DOTFILES EDIT : mise bootstrap dotfiles edit [OPTIONS] : --apply -m, --mode -s, --source -y, --yes -h, --help : MISE BOOTSTRAP DOTFILES STATUS `[dotfiles]` : mise bootstrap dotfiles status [OPTIONS] [] ... : -J, --json JSON --missing ( ) -h, --help : MISE BOOTSTRAP DOTFILES UNAPPLY `[dotfiles]` mise . `--force` . : mise bootstrap dotfiles unapply [OPTIONS] [] ... : -f, --force -n, --dry-run -y, --yes -h, --help : .SH "MISE BOOTSTRAP FILES" `[bootstrap.files]` `[bootstrap.directories]` : mise bootstrap files [OPTIONS] : -h, --help MISE BOOTSTRAP FILES APPLY : mise bootstrap files apply [OPTIONS] : -n, --dry-run -y, --yes --prompt-secrets (secret) bootstrap -h, --help MISE BOOTSTRAP FILES STATUS : mise bootstrap files status [OPTIONS] : -J, --json JSON --missing 1 --prompt-secrets (secret) bootstrap -h, --help MISE BOOTSTRAP FIREWALL `[bootstrap.linux.firewall]` : mise bootstrap firewall [OPTIONS] : -h, --help MISE BOOTSTRAP FIREWALL APPLY : mise bootstrap firewall apply [OPTIONS] : -n, --dry-run -y, --yes -h, --help MISE BOOTSTRAP FIREWALL STATUS : mise bootstrap firewall status [OPTIONS] : -J, --json JSON --missing 1 -h, --help .SH "MISE BOOTSTRAP LINUX" `[bootstrap.linux]` : mise bootstrap linux [OPTIONS] : -h, --help MISE BOOTSTRAP LINUX SYSTEMD-UNITS systemd `[bootstrap.linux.systemd.units]` : mise bootstrap linux systemd-units [OPTIONS] : -h, --help MISE BOOTSTRAP LINUX SYSTEMD-UNITS APPLY : mise bootstrap linux systemd-units apply [OPTIONS] : -n, --dry-run -y, --yes -h, --help MISE BOOTSTRAP LINUX SYSTEMD-UNITS STATUS : mise bootstrap linux systemd-units status [OPTIONS] : -J, --json JSON --missing systemd -h, --help MISE BOOTSTRAP MACOS macOS `[bootstrap.macos]` : mise bootstrap macos [OPTIONS] : -h, --help MISE BOOTSTRAP MACOS DEFAULTS macOS `[bootstrap.macos.defaults]` : mise bootstrap macos defaults [OPTIONS] : -h, --help MISE BOOTSTRAP MACOS DEFAULTS APPLY : mise bootstrap macos defaults apply [OPTIONS] : -n, --dry-run -y, --yes -h, --help .SH "MISE BOOTSTRAP MACOS DEFAULTS STATUS" : mise bootstrap macos defaults status [OPTIONS] : -J, --json JSON --missing (defaults) -h, --help MISE BOOTSTRAP MACOS LAUNCHD-AGENTS LaunchAgent macOS `[bootstrap.macos.launchd.agents]` : mise bootstrap macos launchd-agents [OPTIONS] : -h, --help MISE BOOTSTRAP MACOS LAUNCHD-AGENTS APPLY : mise bootstrap macos launchd-agents apply [OPTIONS] : -n, --dry-run -y, --yes -h, --help MISE BOOTSTRAP MACOS LAUNCHD-AGENTS STATUS : mise bootstrap macos launchd-agents status [OPTIONS] : -J, --json JSON --missing LaunchAgent -h, --help MISE BOOTSTRAP MISE-SHELL-ACTIVATE mise `[bootstrap.mise_shell_activate]` : mise bootstrap mise-shell-activate [OPTIONS] : -h, --help MISE BOOTSTRAP MISE-SHELL-ACTIVATE APPLY : mise bootstrap mise-shell-activate apply [OPTIONS] : -n, --dry-run -y, --yes -h, --help MISE BOOTSTRAP MISE-SHELL-ACTIVATE STATUS : mise bootstrap mise-shell-activate status [OPTIONS] : -J, --json JSON --missing -h, --help .SH "MISE BOOTSTRAP PACKAGES" (bootstrap) `[bootstrap.packages]` : mise bootstrap packages [OPTIONS] : -h, --help MISE BOOTSTRAP PACKAGES APPLY `[bootstrap.packages]` . (root) sudo ( `system_packages.sudo` ) . `manager:package` ( `apk:zlib-dev` `apt:curl` `brew:jq`) . `--manager` . `install` . : mise bootstrap packages apply [OPTIONS] [] ... : -m, --manager -n, --dry-run -y, --yes --update ( apk: `--update-cache` apt: `apt-get update`) -h, --help : `manager:package` [bootstrap.packages] MISE BOOTSTRAP PACKAGES BREW (taps) Homebrew `[bootstrap.brew.taps]` cask tap mise Homebrew . : mise bootstrap packages brew [OPTIONS] : -h, --help MISE BOOTSTRAP PACKAGES BREW TAP (URL) Homebrew [bootstrap.brew.taps] : mise bootstrap packages brew tap [OPTIONS] [] : -l, --local -n, --dry-run -p, --path, --file -h, --help : tap `owner/repo` tap. : https://github.com//homebrew-.git.SH "MISE BOOTSTRAP PACKAGES BREW UNTAP" tap Homebrew [bootstrap.brew.taps] : mise bootstrap packages brew untap [OPTIONS] ... : -l, --local -n, --dry-run -p, --path, --file -h, --help : tap() `owner/repo` MISE BOOTSTRAP PACKAGES IMPORT `[bootstrap.packages]` (formulae) Homebrew . keg . `--all` . : mise bootstrap packages import [OPTIONS] : -e, --env (mise..toml) -g, --global (~/.config/mise/config.toml) -m, --manager . `brew` . : brew --all -n, --dry-run -p, --path, --file -h, --help MISE BOOTSTRAP PACKAGES PRUNE `[bootstrap.packages]` Homebrew cask mise `PackageUninstall` . . mise . : mise bootstrap packages prune [OPTIONS] : -m, --manager : brew -n, --dry-run -y, --yes -h, --help .SH "MISE BOOTSTRAP PACKAGES STATUS" `[bootstrap.packages]` : mise bootstrap packages status [OPTIONS] : -J, --json JSON --missing -h, --help MISE BOOTSTRAP PACKAGES UPGRADE bootstrap `[bootstrap.packages]` : apk/apt/dnf/pacman (apk apt dnf ) brew bottle (pour) keg brew-cask cask flatpak flatpak-user (runtimes) mas App Store . -- `mise bootstrap packages apply` . `manager:package` . : mise bootstrap packages upgrade [OPTIONS] [] ... : -m, --manager -n, --dry-run -y, --yes -h, --help : `manager:package` [bootstrap.packages] MISE BOOTSTRAP PACKAGES USE bootstrap [bootstrap.packages] `mise use` : `"manager:package" = "version"` mise.toml ( `-g` ) . `@` () : `mise bootstrap packages use apt:curl@8.5.0-2`. `@` ( `@latest`) . cask brew ( `brew:postgresql@17` `brew-cask:temurin@17`) `@` Homebrew mise. mas ADAM . : mise bootstrap packages use [OPTIONS] ... : -e, --env (mise..toml) -g, --global (~/.config/mise/config.toml) -n, --dry-run -p, --path, --file -y, --yes -h, --help : `manager:package[@version]`.SH "MISE BOOTSTRAP PLAN" (bootstrap) : mise bootstrap plan [OPTIONS] : -J, --json JSON --detailed-exitcode --prompt-secrets (secret) -h, --help MISE BOOTSTRAP PLUGINS `[bootstrap.plugins]` : mise bootstrap plugins [OPTIONS] : -h, --help MISE BOOTSTRAP PLUGINS APPLY : mise bootstrap plugins apply [OPTIONS] : -n, --dry-run -h, --help MISE BOOTSTRAP PLUGINS STATUS : mise bootstrap plugins status [OPTIONS] : --missing -h, --help MISE BOOTSTRAP REMOTE OpenSSH : mise bootstrap remote [OPTIONS] [] ... : --all inventory --bootstrap-command mise PATH --connect-timeout SSH : 10 --copy-link (dereference) --copy-links (dereference) --exclude --fail-fast --force-dotfiles dotfile --host <[USER@]HOST> SSH (`[user@]host`) -i, --identity-file (identity file) SSH -n, --dry-run --install-mise mise (staging) `~/.local/bin/mise` `--install-mise=` . --keep-staging (staging) --mise-bin mise ( ) --no-install-mise mise --only --port SSH --prompt-secrets --remote-env ( ci,dotfiles) --remote-mise mise (staged) --skip --source --ssh-option