.TH MISE 1 .SH NAME mise \- Dev tools, env vars, and tasks in one CLI .SH SYNOPSIS \fBmise\fR [OPTIONS] [] [] ... [] ... [COMMAND] .SH DESCRIPTION mise installs the dev tools your projects need, sets their environment variables, and runs their tasks. .PP Tools, env vars, and tasks are declared in mise.toml. `mise use ` adds a tool to the project in the current directory, `mise install` installs everything the config asks for, and `mise run ` runs a task. Docs: https://mise.jdx.dev .PP .SH OPTIONS .TP \fB\-c, \-\-continue\-on\-error\fR Continue running tasks even if one fails .TP \fB\-C, \-\-cd\fR \fI\fR Change directory before running command .TP \fB\-E, \-\-env\fR \fI\fR Set the environment for loading `mise..toml` .TP \fB\-f, \-\-force\fR Force the operation .TP \fB\-j, \-\-jobs\fR \fI\fR How many jobs to run in parallel; values below 1 are treated as 1 [default: 8] .RS \fIEnvironment: \fR\fBMISE_JOBS\fR .RE .TP \fB\-n, \-\-dry\-run\fR Dry run, don't actually do anything .TP \fB\-P, \-\-profile\fR \fI\fR Set the profile (environment) .TP \fB\-q, \-\-quiet\fR Suppress non\-error messages .RS \fIEnvironment: \fR\fBMISE_QUIET\fR .RE .TP \fB\-s, \-\-shell\fR \fI\fR .TP \fB\-t, \-\-tool\fR \fI\fR Tool(s) to run in addition to what is in mise.toml files e.g.: node@20 python@3.10 .TP \fB\-v, \-\-verbose\fR Show extra output (use \-vv for even more) .TP \fB\-V, \-\-version\fR .TP \fB\-y, \-\-yes\fR Answer yes to all confirmation prompts .TP \fB\-\-debug\fR Set the log level to debug .TP \fB\-\-log\-level\fR \fI\fR .TP \fB\-\-no\-config\fR Do not load any config files Can also use `MISE_NO_CONFIG=1` .TP \fB\-\-no\-env\fR Do not load environment variables from config files Can also use `MISE_NO_ENV=1` .TP \fB\-\-no\-hooks\fR Do not execute hooks from config files Can also use `MISE_NO_HOOKS=1` .TP \fB\-\-no\-timings\fR Hide the elapsed time printed after each task completes Set `MISE_TASK_TIMINGS=0` to hide it by default .TP \fB\-\-output\fR \fI\fR How task output is displayed when running a task (same as `mise run \-\-output`) .TP \fB\-\-raw\fR Read/write directly to stdin/stdout/stderr instead of by line .TP \fB\-\-locked\fR Require lockfile URLs to be present during installation Fails if tools don't have pre\-resolved URLs in the lockfile for the current platform. This prevents API calls to GitHub, aqua registry, etc. Can also be enabled via MISE_LOCKED=1 or settings.locked=true .TP \fB\-\-silent\fR Suppress all task output and mise non\-error messages .TP \fB\-\-timings\fR Show the elapsed time after each task completes Set `MISE_TASK_TIMINGS=1` to show it by default .TP \fB\-\-trace\fR Set the log level to trace .TP \fB\-h, \-\-help\fR Print help .SH ARGUMENTS .TP \fB\fR Task to run. Shorthand for `mise tasks run `. .TP \fB\fR Task arguments .SH COMMANDS .TP \fBactivate\fR Print the script to activate mise in an interactive shell .TP \fBtool\-alias\fR Manage tool version aliases .RS \fIAliases: \fRalias, aliases .RE .TP \fBtool\-alias get\fR Show a configured version alias for a tool .TP \fBtool\-alias ls\fR List tool version aliases .RS \fIAliases: \fRlist .RE .TP \fBtool\-alias set\fR Add/update an alias for a tool/backend .RS \fIAliases: \fRadd, create .RE .TP \fBtool\-alias unset\fR Clear an alias for a tool/backend .RS \fIAliases: \fRrm, remove, delete, del .RE .TP \fBbackends\fR Manage backends .RS \fIAliases: \fRb, backend, backend\-list .RE .TP \fBbackends ls\fR List built\-in backends .RS \fIAliases: \fRlist .RE .TP \fBbin\-paths\fR List all the active runtime bin paths .TP \fBbootstrap\fR Set up a machine from the current configuration .RS \fIAliases: \fRbs .RE .TP \fBbootstrap accounts\fR Manage Linux users and groups from `[bootstrap.users]` and `[bootstrap.groups]` .TP \fBbootstrap accounts apply\fR Apply configured Linux users and groups .TP \fBbootstrap accounts status\fR Show configured Linux user and group state .TP \fBbootstrap compose\fR Manage Docker Compose projects from `[bootstrap.compose]` .TP \fBbootstrap compose apply\fR Apply configured Docker Compose project state .TP \fBbootstrap compose status\fR Show configured Docker Compose project state .TP \fBbootstrap dotfiles\fR Manage dotfiles from `[dotfiles]` .TP \fBbootstrap dotfiles add\fR Add or update dotfiles in `[dotfiles]` .TP \fBbootstrap dotfiles apply\fR Apply dotfiles from `[dotfiles]` .TP \fBbootstrap dotfiles capture\fR Record tracked files before and after an external command .TP \fBbootstrap dotfiles conflicts\fR Inspect the local and remote sides of sharing conflicts .TP \fBbootstrap dotfiles diff\fR Show the changes needed to apply dotfiles from `[dotfiles]` .TP \fBbootstrap dotfiles edit\fR Edit a managed dotfile source .TP \fBbootstrap dotfiles exclude\fR Never capture paths matching a glob .TP \fBbootstrap dotfiles history\fR Browse the checkpoints of your dotfiles .TP \fBbootstrap dotfiles history describe\fR Set the description of a checkpoint .TP \fBbootstrap dotfiles history diff\fR Compare checkpoints, or the working tree against one .TP \fBbootstrap dotfiles history ls\fR List checkpoints, newest first .RS \fIAliases: \fRlist .RE .TP \fBbootstrap dotfiles history show\fR Show one checkpoint: what triggered it, what changed, and its journal .TP \fBbootstrap dotfiles include\fR Capture paths matching a glob again .TP \fBbootstrap dotfiles origin\fR Connect or disconnect the setup repository .TP \fBbootstrap dotfiles origin set\fR Connect a setup repository .TP \fBbootstrap dotfiles paths\fR Show what history tracks and under which policies .TP \fBbootstrap dotfiles pull\fR Pull incoming shared changes into the live files .TP \fBbootstrap dotfiles recover\fR Recover an interrupted dotfile operation .TP \fBbootstrap dotfiles rollback\fR Return files to the version a checkpoint holds .TP \fBbootstrap dotfiles save\fR Save a checkpoint of the tracked files now .TP \fBbootstrap dotfiles status\fR Show the status of dotfiles from `[dotfiles]` .RS \fIAliases: \fRls .RE .TP \fBbootstrap dotfiles sync\fR Publish, fetch, and record what is pending now .TP \fBbootstrap dotfiles track\fR Track a file or directory in place .TP \fBbootstrap dotfiles unapply\fR Remove dotfiles applied from `[dotfiles]` .TP \fBbootstrap dotfiles undo\fR Reverse the tracked\-file changes from an operation .TP \fBbootstrap dotfiles untrack\fR Stop tracking a file or directory .TP \fBbootstrap dotfiles watch\fR Save tracked files as they change .TP \fBbootstrap files\fR Manage privileged files and directories from `[bootstrap.files]` and `[bootstrap.directories]` .TP \fBbootstrap files apply\fR Apply configured privileged files and directories .TP \fBbootstrap files status\fR Show configured privileged file and directory state .TP \fBbootstrap firewall\fR Manage the Linux host firewall from `[bootstrap.linux.firewall]` .TP \fBbootstrap firewall apply\fR Apply the configured Linux host firewall .TP \fBbootstrap firewall status\fR Show configured Linux host firewall state .TP \fBbootstrap linux\fR Manage Linux bootstrap config from `[bootstrap.linux]` .TP \fBbootstrap linux systemd\-units\fR Manage systemd user services from `[bootstrap.linux.systemd.units]` .RS \fIAliases: \fRsystemd .RE .TP \fBbootstrap linux systemd\-units apply\fR Install and start systemd user services from `[bootstrap.linux.systemd.units]` .TP \fBbootstrap linux systemd\-units status\fR Show the state of systemd user services from `[bootstrap.linux.systemd.units]` .TP \fBbootstrap macos\fR Manage macOS bootstrap config from `[bootstrap.macos]` .TP \fBbootstrap macos defaults\fR Manage macOS defaults from `[bootstrap.macos.defaults]` .TP \fBbootstrap macos defaults apply\fR Write macOS defaults from `[bootstrap.macos.defaults]` .TP \fBbootstrap macos defaults status\fR Show whether macOS defaults match `[bootstrap.macos.defaults]` .TP \fBbootstrap macos launchd\-agents\fR Manage macOS LaunchAgents from `[bootstrap.macos.launchd.agents]` .RS \fIAliases: \fRlaunchd .RE .TP \fBbootstrap macos launchd\-agents apply\fR Install and load LaunchAgents from `[bootstrap.macos.launchd.agents]` .TP \fBbootstrap macos launchd\-agents status\fR Show the state of LaunchAgents from `[bootstrap.macos.launchd.agents]` .TP \fBbootstrap mise\-shell\-activate\fR Manage mise shell activation from `[bootstrap.mise_shell_activate]` .RS \fIAliases: \fRshell .RE .TP \fBbootstrap mise\-shell\-activate apply\fR Configure shell activation from `[bootstrap.mise_shell_activate]` .TP \fBbootstrap mise\-shell\-activate status\fR Show whether shell activation matches `[bootstrap.mise_shell_activate]` .TP \fBbootstrap packages\fR Manage bootstrap system packages from `[bootstrap.packages]` .TP \fBbootstrap packages apply\fR Apply system packages from `[bootstrap.packages]` .RS \fIAliases: \fRi, install .RE .TP \fBbootstrap packages brew\fR Manage Homebrew taps used by bootstrap packages .TP \fBbootstrap packages brew tap\fR Add a Homebrew tap URL to [bootstrap.brew.taps] .TP \fBbootstrap packages brew untap\fR Remove Homebrew tap URLs from [bootstrap.brew.taps] .RS \fIAliases: \fRremove, rm .RE .TP \fBbootstrap packages export\fR Export active Nix bootstrap packages as a NixOS module .TP \fBbootstrap packages import\fR Import installed system packages into `[bootstrap.packages]` .TP \fBbootstrap packages prune\fR Prune installed system packages no longer declared in `[bootstrap.packages]` .TP \fBbootstrap packages status\fR Show the status of system packages from `[bootstrap.packages]` .RS \fIAliases: \fRls .RE .TP \fBbootstrap packages upgrade\fR Upgrade installed bootstrap packages from `[bootstrap.packages]` .RS \fIAliases: \fRup .RE .TP \fBbootstrap packages use\fR Add bootstrap packages to [bootstrap.packages] and install them .RS \fIAliases: \fRu .RE .TP \fBbootstrap packages where\fR Print the stable root of an installed Homebrew formula .TP \fBbootstrap plan\fR Show the changes declarative bootstrap resources would make .TP \fBbootstrap plugins\fR Manage package manager plugins declared in `[bootstrap.plugins]` .TP \fBbootstrap plugins apply\fR Install package manager plugins declared in `[bootstrap.plugins]` .TP \fBbootstrap plugins status\fR Show whether declared package manager plugins are installed .TP \fBbootstrap remote\fR Bootstrap one or more machines over OpenSSH .TP \fBbootstrap repos\fR Manage git repo checkouts from `[bootstrap.repos]` .TP \fBbootstrap repos apply\fR Clone and converge git repos from `[bootstrap.repos]` .TP \fBbootstrap repos exec\fR Run a command in each configured git repo .TP \fBbootstrap repos status\fR Show the state of git repos from `[bootstrap.repos]` .TP \fBbootstrap repos update\fR Pull the latest changes into configured git repos .TP \fBbootstrap secrets\fR Inspect bootstrap secret inputs without revealing their values .TP \fBbootstrap secrets status\fR Show whether declared bootstrap secret inputs are available .TP \fBbootstrap services\fR Manage services from `[bootstrap.services]` .TP \fBbootstrap services apply\fR Apply configured service state (system and user scope) .TP \fBbootstrap services remove\fR Remove an installed user\-scope service, declared or not .TP \fBbootstrap services status\fR Show configured service state (system and user scope) .TP \fBbootstrap status\fR Show the aggregate bootstrap status .RS \fIAliases: \fRls .RE .TP \fBbootstrap user\fR Manage current\-user bootstrap settings from `[bootstrap.user]` .TP \fBbootstrap user apply\fR Apply current\-user settings from `[bootstrap.user]` .TP \fBbootstrap user status\fR Show whether current\-user settings match `[bootstrap.user]` .TP \fBcache\fR Manage the mise cache .TP \fBcache clear\fR Delete all cache files .RS \fIAliases: \fRc, clean .RE .TP \fBcache path\fR Show the cache directory path .RS \fIAliases: \fRdir .RE .TP \fBcache prune\fR Remove stale cache files .RS \fIAliases: \fRp .RE .TP \fBcache task\fR Inspect output cache entries for a task .TP \fBcompletion\fR Generate shell completions .RS \fIAliases: \fRcomplete, completions .RE .TP \fBconfig\fR Manage config files .RS \fIAliases: \fRcfg, toml .RE .TP \fBconfig get\fR Display a value from one mise TOML file .TP \fBconfig ls\fR List config files currently in use .RS \fIAliases: \fRlist .RE .TP \fBconfig set\fR Set a value in one mise TOML file .TP \fBdeactivate\fR Print the script to disable mise in the current shell session .TP \fBdaemons\fR [experimental] Manage project daemons with pitchfork .RS \fIAliases: \fRdaemon .RE .TP \fBdaemons start\fR Arguments passed to pitchfork; daemon names may be short or qualified. .TP \fBdaemons stop\fR Arguments passed to pitchfork; daemon names may be short or qualified. .TP \fBdaemons restart\fR Arguments passed to pitchfork; daemon names may be short or qualified. .TP \fBdaemons ls\fR List project daemons without starting a supervisor or registering configuration. .RS \fIAliases: \fRlist .RE .TP \fBdaemons logs\fR Arguments passed to pitchfork; daemon names may be short or qualified. .TP \fBdaemons status\fR Arguments passed to pitchfork; daemon names may be short or qualified. .TP \fBdaemons tui\fR Open pitchfork's dashboard with optional pitchfork TUI flags. .TP \fBdotfiles\fR Manage dotfiles from `[dotfiles]` .RS \fIAliases: \fRdot .RE .TP \fBdotfiles add\fR Add or update dotfiles in `[dotfiles]` .TP \fBdotfiles apply\fR Apply dotfiles from `[dotfiles]` .TP \fBdotfiles capture\fR Record tracked files before and after an external command .TP \fBdotfiles conflicts\fR Inspect the local and remote sides of sharing conflicts .TP \fBdotfiles diff\fR Show the changes needed to apply dotfiles from `[dotfiles]` .TP \fBdotfiles edit\fR Edit a managed dotfile source .TP \fBdotfiles exclude\fR Never capture paths matching a glob .TP \fBdotfiles history\fR Browse the checkpoints of your dotfiles .TP \fBdotfiles history describe\fR Set the description of a checkpoint .TP \fBdotfiles history diff\fR Compare checkpoints, or the working tree against one .TP \fBdotfiles history ls\fR List checkpoints, newest first .RS \fIAliases: \fRlist .RE .TP \fBdotfiles history show\fR Show one checkpoint: what triggered it, what changed, and its journal .TP \fBdotfiles include\fR Capture paths matching a glob again .TP \fBdotfiles origin\fR Connect or disconnect the setup repository .TP \fBdotfiles origin set\fR Connect a setup repository .TP \fBdotfiles paths\fR Show what history tracks and under which policies .TP \fBdotfiles pull\fR Pull incoming shared changes into the live files .TP \fBdotfiles recover\fR Recover an interrupted dotfile operation .TP \fBdotfiles rollback\fR Return files to the version a checkpoint holds .TP \fBdotfiles save\fR Save a checkpoint of the tracked files now .TP \fBdotfiles status\fR Show the status of dotfiles from `[dotfiles]` .RS \fIAliases: \fRls .RE .TP \fBdotfiles sync\fR Publish, fetch, and record what is pending now .TP \fBdotfiles track\fR Track a file or directory in place .TP \fBdotfiles unapply\fR Remove dotfiles applied from `[dotfiles]` .TP \fBdotfiles undo\fR Reverse the tracked\-file changes from an operation .TP \fBdotfiles untrack\fR Stop tracking a file or directory .TP \fBdotfiles watch\fR Save tracked files as they change .TP \fBdoctor\fR Check mise installation for possible problems .RS \fIAliases: \fRdr .RE .TP \fBdoctor path\fR Print the current PATH entries mise is providing .RS \fIAliases: \fRpaths .RE .TP \fBdoctor project\fR Run the project's diagnostic checks .TP \fBen\fR Start a new shell with the mise environment built from the current configuration .TP \fBenv\fR Print the environment for the current configuration .RS \fIAliases: \fRe .RE .TP \fBexec\fR Execute a command with tool(s) set .RS \fIAliases: \fRx .RE .TP \fBfmt\fR Format mise TOML configuration .TP \fBgenerate\fR Generate files for various tools/services .RS \fIAliases: \fRgen, g .RE .TP \fBgenerate config\fR Generate a mise.toml file .TP \fBgenerate devcontainer\fR Generate devcontainer configuration for mise .TP \fBgenerate git\-pre\-commit\fR Generate a git pre\-commit hook .RS \fIAliases: \fRpre\-commit .RE .TP \fBgenerate github\-action\fR Generate a GitHub Action workflow file .TP \fBgenerate install\-script\fR Generate a script to download+execute mise .TP \fBgenerate task\-docs\fR Generate Markdown documentation for project tasks .TP \fBgenerate task\-stubs\fR Generate shims to run mise tasks .TP \fBgenerate tool\-stub\fR Generate a tool stub for HTTP\-based tools .TP \fBimplode\fR Remove the mise CLI and all related data .TP \fBedit\fR Edit mise.toml interactively .TP \fBinstall\fR Install a tool version .RS \fIAliases: \fRi .RE .TP \fBinstall\-into\fR Install a tool version to a specific path .TP \fBlatest\fR Resolve the latest matching version request for a tool .TP \fBlink\fR Symlink a tool version into mise .RS \fIAliases: \fRln .RE .TP \fBlock\fR Create or refresh lockfile versions, checksums, and download URLs .TP \fBls\fR List installed and active tool versions .RS \fIAliases: \fRlist .RE .TP \fBls\-remote\fR List tool versions available to install .RS \fIAliases: \fRlist\-all, list\-remote .RE .TP \fBmcp\fR Run the Model Context Protocol server over stdin/stdout .TP \fBoci\fR [experimental] Build OCI container images from a mise.toml .TP \fBoci build\fR [experimental] Build an OCI image from the current mise.toml .TP \fBoci push\fR [experimental] Build an OCI image and push it to a registry .TP \fBoci run\fR [experimental] Build an OCI image from the current mise.toml and run a command in it .TP \fBpackslip\fR The signers mise accepts packslips from .TP \fBpackslip forget\fR Forget a project's pinned signer, so the next release accepted sets it again .TP \fBpackslip pins\fR List the signers mise has accepted packslips from .RS \fIAliases: \fRlist .RE .TP \fBoutdated\fR Show outdated tool versions .TP \fBpatrons\fR Show the individuals supporting mise as Patron\-tier members .TP \fBplugins\fR Manage plugins .RS \fIAliases: \fRp, plugin, plugin\-list .RE .TP \fBplugins install\fR Install a plugin from a configured source, Git URL, or supported archive .RS \fIAliases: \fRi, a, add .RE .TP \fBplugins link\fR Link a local plugin directory into mise for development .RS \fIAliases: \fRln .RE .TP \fBplugins ls\fR List installed external plugins .RS \fIAliases: \fRlist .RE .TP \fBplugins ls\-remote\fR List all available remote plugins .RS \fIAliases: \fRlist\-remote, list\-all .RE .TP \fBplugins uninstall\fR Remove an installed plugin .RS \fIAliases: \fRremove, rm .RE .TP \fBplugins update\fR Update a plugin to the latest version .RS \fIAliases: \fRup, upgrade .RE .TP \fBdeps\fR [experimental] Manage project dependencies .RS \fIAliases: \fRdep, prepare .RE .TP \fBdeps add\fR Add a dependency .TP \fBdeps install\fR Install all project dependencies .TP \fBdeps remove\fR Remove a dependency .TP \fBprune\fR Delete unused versions of tools .TP \fBregistry\fR List registry shorthand names and their backends .TP \fBreshim\fR Create shims for executables provided by installed tools .TP \fBrun\fR Run tasks and their dependencies .RS \fIAliases: \fRr .RE .TP \fBsearch\fR Search for available tools .TP \fBself\-update\fR Update mise itself .TP \fBset\fR Set environment variables in mise.toml .RS \fIAliases: \fRev, env\-vars .RE .TP \fBsettings\fR Manage settings .TP \fBsettings add\fR Append a value to an array setting .TP \fBsettings get\fR Show the effective value of a setting .TP \fBsettings ls\fR List configured settings and their sources .RS \fIAliases: \fRlist .RE .TP \fBsettings set\fR Add/update a setting .RS \fIAliases: \fRcreate .RE .TP \fBsettings unset\fR Clear a setting .RS \fIAliases: \fRrm, remove, delete, del .RE .TP \fBshell\fR Set a tool version for the current shell session .RS \fIAliases: \fRsh .RE .TP \fBssh\fR Open an SSH session, optionally borrowing read\-only GitHub access .TP \fBshell\-alias\fR Manage shell aliases .TP \fBshell\-alias get\fR Show the command for a shell alias .TP \fBshell\-alias ls\fR List shell aliases .RS \fIAliases: \fRlist .RE .TP \fBshell\-alias set\fR Add/update a shell alias .RS \fIAliases: \fRadd, create .RE .TP \fBshell\-alias unset\fR Remove a shell alias .RS \fIAliases: \fRrm, remove, delete, del .RE .TP \fBskills\fR Agent skills the active tools ship, from their packslips .RS \fIAliases: \fRskill .RE .TP \fBskills ls\fR List the skills the active tools declare .RS \fIAliases: \fRlist .RE .TP \fBskills sync\fR Link the active tools' skills where an agent looks for them .TP \fBsponsors\fR Show the companies sponsoring mise and the jdx.dev open source tools .TP \fBsync\fR Synchronize tools from other version managers with mise .TP \fBsync node\fR Symlink node versions installed by nvm, nodenv, or Homebrew into mise .TP \fBsync python\fR Symlink python versions installed by pyenv or uv into mise .TP \fBsync ruby\fR Symlink ruby versions installed by Homebrew into mise .TP \fBtasks\fR Manage tasks .RS \fIAliases: \fRt, task .RE .TP \fBtasks add\fR Create a new task .TP \fBtasks deps\fR Display a tree visualization of a dependency graph .TP \fBtasks edit\fR Edit a task with $EDITOR .TP \fBtasks graph\fR [experimental] Inspect the workspace project graph .TP \fBtasks info\fR Get information about a task .TP \fBtasks ls\fR List available tasks .TP \fBtasks run\fR Run tasks and their dependencies .RS \fIAliases: \fRr .RE .TP \fBtasks validate\fR Validate tasks for common errors and issues .TP \fBtest\-tool\fR Test that a tool installs and runs .TP \fBtoken\fR Display git provider tokens mise will use .TP \fBtoken forgejo\fR Display the Forgejo token mise will use for a given host .TP \fBtoken github\fR Display the GitHub token mise will use for a given host .TP \fBtoken gitlab\fR Display the GitLab token mise will use for a given host .TP \fBtool\fR Show information about a tool .TP \fBtool\-stub\fR Execute a tool stub .TP \fBtrust\fR Mark a config file as trusted .TP \fBuninstall\fR Remove installed tool versions .TP \fBunset\fR Remove environment variable(s) from the config file .TP \fBuntrust\fR Remove explicit trust for a config .TP \fBunuse\fR Remove tool requests from configuration and prune unused installations .RS \fIAliases: \fRrm, remove .RE .TP \fBupgrade\fR Upgrade outdated tools .RS \fIAliases: \fRup .RE .TP \fBuse\fR Install a tool and add it to configuration .RS \fIAliases: \fRu .RE .TP \fBversion\fR Display the version of mise .RS \fIAliases: \fRv .RE .TP \fBwatch\fR Run task(s) and rerun them when files change .RS \fIAliases: \fRw .RE .TP \fBwhere\fR Display the installation path for a tool .TP \fBwhich\fR Show the path a tool's executable resolves to .SH "MISE ACTIVATE" Print the script to activate mise in an interactive shell Evaluate this command's output with the syntax for your shell; running it alone only prints the script. Activation updates tools and environment variables as this shell changes directories. Add the appropriate example below once to your interactive startup file: ~/.bashrc for Bash, ~/.zshrc for Zsh, ~/.config/fish/config.fish for Fish, or $PROFILE for PowerShell. See the getting\-started guide for other shells. The mise executable must be on PATH before that line runs. Otherwise use its absolute path, for example `eval "$(~/.local/bin/mise activate zsh)"`. Use `mise exec \-\- command` for scripts and CI that do not need interactive hooks. Customize status output with the `status` settings. .PP \fBUsage:\fR mise activate [OPTIONS] [] .PP \fBOptions:\fR .PP .TP \fB\-q, \-\-quiet\fR Suppress non\-error messages .TP \fB\-s, \-\-shell\fR \fI\fR Shell type to generate the script for .TP \fB\-\-no\-hook\-env\fR Do not automatically call hook\-env This can be helpful for debugging mise. If you run `eval "$(mise activate \-\-no\-hook\-env)"`, then you can call `mise hook\-env` manually which will output the env vars to stdout without actually modifying the environment. That way you can do things like `mise hook\-env \-\-trace` to get more information or just see the values that hook\-env is outputting. .TP \fB\-\-shims\fR Use shims instead of modifying PATH Effectively the same as: PATH="$HOME/.local/share/mise/shims:$PATH" `mise activate \-\-shims` does not support all the features of `mise activate`. See https://mise.jdx.dev/dev\-tools/shims.html#shims\-vs\-path for more information .TP \fB\-\-status\fR Show "mise: @" message when changing directories .TP \fB\-h, \-\-help\fR Print help \fBArguments:\fR .PP .TP \fB\fR Shell type to generate the script for \fBExamples:\fR .PP Activate mise in Bash. .PP .RS 4 eval "$(mise activate bash)" .RE .PP Activate mise in Zsh. .PP .RS 4 eval "$(mise activate zsh)" .RE .PP Activate mise in Fish. .PP .RS 4 mise activate fish | source .RE .PP Activate mise in Xonsh. .PP .RS 4 execx($(mise activate xonsh)) .RE .PP Activate mise in PowerShell. .PP .RS 4 (&mise activate pwsh) | Out\-String | Invoke\-Expression .RE .SH "MISE TOOL-ALIAS" Manage tool version aliases .PP \fBUsage:\fR mise tool\-alias [OPTIONS] [COMMAND] .PP \fBOptions:\fR .PP .TP \fB\-p, \-\-tool\fR \fI\fR Filter aliases by tool .TP \fB\-\-no\-header\fR Don't show table header .TP \fB\-h, \-\-help\fR Print help .SH "MISE TOOL-ALIAS GET" Show a configured version alias for a tool Reads the merged `[tool_alias.TOOL.versions]` configuration. This prints the stored request, which may itself be a prefix. Backend\-provided aliases are listed by `mise tool\-alias ls`; they are not entries returned by this command. .PP \fBUsage:\fR mise tool\-alias get [OPTIONS] .PP \fBOptions:\fR .PP .TP \fB\-h, \-\-help\fR Print help \fBArguments:\fR .PP .TP \fB\fR The tool to show the alias for .TP \fB\fR The alias to show \fBExamples:\fR .PP .PP .RS 4 mise tool\-alias set node project 20 mise tool\-alias get node project 20 .RE .SH "MISE TOOL-ALIAS LS" List tool version aliases Aliases can be defined in user config or provided by plugins via `bin/list\-aliases`. In user config, aliases are defined like the following in `~/.config/mise/config.toml`: [tool_alias.node.versions] project = "20" .PP \fBUsage:\fR mise tool\-alias ls [OPTIONS] [] .PP \fBOptions:\fR .PP .TP \fB\-\-no\-header\fR Don't show table header .TP \fB\-h, \-\-help\fR Print help \fBArguments:\fR .PP .TP \fB\fR Show aliases for \fBExamples:\fR .PP .PP .RS 4 mise tool\-alias ls node lts\-jod 22 .RE .SH "MISE TOOL-ALIAS SET" Add/update an alias for a tool/backend This modifies the contents of ~/.config/mise/config.toml .PP \fBUsage:\fR mise tool\-alias set [OPTIONS] [] .PP \fBOptions:\fR .PP .TP \fB\-h, \-\-help\fR Print help \fBArguments:\fR .PP .TP \fB\fR The tool/backend to set the alias for .TP \fB\fR The alias to set .TP \fB\fR The value to set the alias to \fBExamples:\fR .PP .PP .RS 4 mise tool\-alias set ripgrep aqua:BurntSushi/ripgrep mise tool\-alias set node project 20 .RE .SH "MISE TOOL-ALIAS UNSET" Clear an alias for a tool/backend This modifies the contents of ~/.config/mise/config.toml .PP \fBUsage:\fR mise tool\-alias unset [OPTIONS] [] .PP \fBOptions:\fR .PP .TP \fB\-h, \-\-help\fR Print help \fBArguments:\fR .PP .TP \fB\fR The tool/backend to remove the alias from .TP \fB\fR The alias to remove \fBExamples:\fR .PP .PP .RS 4 mise tool\-alias unset ripgrep mise tool\-alias unset node project .RE .SH "MISE BACKENDS" Manage backends .PP \fBUsage:\fR mise backends [OPTIONS] [COMMAND] .PP \fBOptions:\fR .PP .TP \fB\-h, \-\-help\fR Print help .SH "MISE BACKENDS LS" List built\-in backends .PP \fBUsage:\fR mise backends ls [OPTIONS] .PP \fBOptions:\fR .PP .TP \fB\-h, \-\-help\fR Print help \fBExamples:\fR .PP Installed plugin availability and built\-in backends are separate lists .PP .RS 4 mise backends ls mise plugins ls .RE .SH "MISE BIN-PATHS" List all the active runtime bin paths .PP \fBUsage:\fR mise bin\-paths [OPTIONS] [] ... .PP \fBOptions:\fR .PP .TP \fB\-\-bin\-names\fR Output executable names instead of bin directories .TP \fB\-J, \-\-json\fR Output executable entries in JSON format (implies \-\-bin\-names) .TP \fB\-h, \-\-help\fR Print help \fBArguments:\fR .PP .TP \fB\fR Tool(s) to look up e.g.: ruby@3 .SH "MISE BOOTSTRAP" Set up a machine from the current configuration Runs these phases in order, when configured and selected: 1. Linux accounts, then package\-manager plugins. 2. Pre\-packages files/directories, the pre\-packages hook, then packages handled by built\-in managers. 3. Privileged files/directories, system and user services, firewall, and Compose projects. 4. Git repositories, then dotfiles, each with its pre/post hooks. 5. Shell activation, macOS defaults and LaunchAgents, Linux user units, and user settings. 6. The pre\-tools hook, versioned tools, and post\-tools hook. 7. Package\-plugin packages, then the post\-packages hook and services requiring tools. 8. The `bootstrap` task, when defined, then the final hook. Defaults and user settings also have pre/post hooks. See https://mise.jdx.dev/bootstrap.html for the complete phase order and configuration. Unchanged resource state is skipped, but hooks and the bootstrap task can run again; make those commands safe to repeat. Dotfile templates may execute while checking state. Use `\-\-dry\-run` to preview the selected workflow, `bootstrap status` to inspect state, or `bootstrap plan` for the declarative\-resource plan. `\-\-only` and `\-\-skip` accept repeated or comma\-separated parts and cannot be combined. .PP \fBUsage:\fR mise bootstrap [OPTIONS] [COMMAND] .PP \fBOptions:\fR .PP .TP \fB\-\-from\fR \fI\fR Clone a git repository and bootstrap from its configuration .TP \fB\-\-adopt\fR \fI\fR Adopt global configuration or shared dotfile history from a Git repository, then bootstrap .TP \fB\-\-replace\-history\fR Replace local dotfile history while adopting a setup repository .TP \fB\-\-from\-dir\fR \fI\fR Directory used for the repository cloned by \-\-from .TP \fB\-n, \-\-dry\-run\fR Print what would happen without installing anything .TP \fB\-y, \-\-yes\fR Skip confirmation prompts .TP \fB\-\-skip\-dirty\fR Skip configured repos with local changes instead of failing .TP \fB\-\-force\-dotfiles\fR Overwrite existing files that conflict with whole\-file dotfile entries .TP \fB\-\-only\fR \fI\fR Run only one or more bootstrap parts Can be passed multiple times or as a comma\-separated list. Cannot be used with `\-\-skip`. .TP \fB\-\-prompt\-secrets\fR Prompt securely for missing bootstrap secret inputs .TP \fB\-\-skip\fR \fI\fR Skip one or more bootstrap parts Can be passed multiple times or as a comma\-separated list. .TP \fB\-\-update\fR Refresh package manager metadata and update configured repos .TP \fB\-h, \-\-help\fR Print help \fBExamples:\fR .PP .PP .RS 4 mise bootstrap # packages + repos + dotfiles + tools + bootstrap task mise \-E work bootstrap \-\-from git@github.com:example/dotfiles.git \-\-yes mise bootstrap \-\-adopt git@github.com:example/mise\-config.git \-\-yes mise bootstrap \-\-adopt git@github.com:example/mise\-config.git \-\-replace\-history \-\-yes mise bootstrap \-\-force\-dotfiles # replace conflicting dotfile targets mise bootstrap \-\-skip tools,task # skip tool installation and the bootstrap task mise bootstrap \-\-only tools # run just tool installation mise bootstrap status \-\-missing mise bootstrap packages apply \-\-yes mise bootstrap repos status mise bootstrap repos apply \-\-dry\-run mise dot status mise bootstrap mise\-shell\-activate apply \-\-dry\-run mise bootstrap macos defaults status mise bootstrap macos launchd\-agents apply \-\-dry\-run mise bootstrap linux systemd\-units apply \-\-dry\-run mise bootstrap user apply \-\-dry\-run .RE .SH "MISE BOOTSTRAP ACCOUNTS" Manage Linux users and groups from `[bootstrap.users]` and `[bootstrap.groups]` These are system accounts on the target Linux host. Inspect `status` or an apply preview before changing user IDs, memberships, or account state. .PP \fBUsage:\fR mise bootstrap accounts [OPTIONS] .PP \fBOptions:\fR .PP .TP \fB\-h, \-\-help\fR Print help .SH "MISE BOOTSTRAP ACCOUNTS APPLY" Apply configured Linux users and groups .PP \fBUsage:\fR mise bootstrap accounts apply [OPTIONS] .PP \fBOptions:\fR .PP .TP \fB\-n, \-\-dry\-run\fR Print what would change without changing anything .TP \fB\-y, \-\-yes\fR Skip the confirmation prompt .TP \fB\-h, \-\-help\fR Print help .SH "MISE BOOTSTRAP ACCOUNTS STATUS" Show configured Linux user and group state .PP \fBUsage:\fR mise bootstrap accounts status [OPTIONS] .PP \fBOptions:\fR .PP .TP \fB\-J, \-\-json\fR Output in JSON format .TP \fB\-\-missing\fR Exit with code 1 when any account is not converged .TP \fB\-h, \-\-help\fR Print help .SH "MISE BOOTSTRAP COMPOSE" Manage Docker Compose projects from `[bootstrap.compose]` Requires a working Docker engine and Compose command on the target host. `apply` reconciles declared project state; `status` inspects the existing projects. .PP \fBUsage:\fR mise bootstrap compose [OPTIONS] .PP \fBOptions:\fR .PP .TP \fB\-h, \-\-help\fR Print help .SH "MISE BOOTSTRAP COMPOSE APPLY" Apply configured Docker Compose project state .PP \fBUsage:\fR mise bootstrap compose apply [OPTIONS] .PP \fBOptions:\fR .PP .TP \fB\-n, \-\-dry\-run\fR Print what would change without changing anything .TP \fB\-y, \-\-yes\fR Skip the confirmation prompt .TP \fB\-h, \-\-help\fR Print help .SH "MISE BOOTSTRAP COMPOSE STATUS" Show configured Docker Compose project state .PP \fBUsage:\fR mise bootstrap compose status [OPTIONS] .PP \fBOptions:\fR .PP .TP \fB\-J, \-\-json\fR Output in JSON format .TP \fB\-\-missing\fR Exit with code 1 when any Compose project is not converged .TP \fB\-h, \-\-help\fR Print help .SH "MISE BOOTSTRAP DOTFILES" Manage dotfiles from `[dotfiles]` .PP \fBUsage:\fR mise bootstrap dotfiles [OPTIONS] .PP \fBOptions:\fR .PP .TP \fB\-h, \-\-help\fR Print help .SH "MISE BOOTSTRAP DOTFILES ADD" Add or update dotfiles in `[dotfiles]` If the target is already managed, this updates its source from the live target. Otherwise it creates a `[dotfiles]` entry and seeds the source under `dotfiles.root` unless `\-\-source` is provided. Captured entries are applied unless `\-\-no\-apply` is passed. Use `\-\-dry\-run` to preview both the source capture and config write without making those changes. .PP \fBUsage:\fR mise bootstrap dotfiles add [OPTIONS] [] ... .PP \fBOptions:\fR .PP .TP \fB\-\-changed\fR Update the sources of every changed file managed in copy mode .TP \fB\-f, \-\-force\fR Overwrite existing sources without prompting .TP \fB\-g, \-\-global\fR Write to the global config .TP \fB\-l, \-\-local\fR Write to the local config instead of the global config .TP \fB\-m, \-\-mode\fR \fI\fR Dotfile mode to write .TP \fB\-n, \-\-dry\-run\fR Print the config/source updates without writing anything .TP \fB\-\-no\-apply\fR Add the entry without applying it .TP \fB\-p, \-\-path\fR \fI\fR Write to this config file or directory .TP \fB\-s, \-\-source\fR \fI\fR Source path to use for a single target .TP \fB\-y, \-\-yes\fR Skip the confirmation prompt .TP \fB\-\-prompt\-secrets\fR Prompt securely for missing bootstrap secret inputs .TP \fB\-h, \-\-help\fR Print help \fBArguments:\fR .PP .TP \fB\fR Targets to add or update \fBExamples:\fR .PP .PP .RS 4 mise dot add ~/.zshrc mise dot add \-\-mode copy ~/.config/starship.toml mise dot add \-\-source dotfiles/gitconfig ~/.gitconfig mise dot add \-\-changed .RE .SH "MISE BOOTSTRAP DOTFILES APPLY" Apply dotfiles from `[dotfiles]` Applies configured whole\-file entries and edits that aren't in their desired state. Whole\-file entries may symlink, copy, or render templates. Edit entries manage a marker\-delimited block or a single line in a file mise doesn't otherwise own. .PP \fBUsage:\fR mise bootstrap dotfiles apply [OPTIONS] [] ... .PP \fBOptions:\fR .PP .TP \fB\-f, \-\-force\fR Overwrite existing files that conflict with whole\-file dotfile entries .TP \fB\-n, \-\-dry\-run\fR Print the actions that would run without writing anything .TP \fB\-y, \-\-yes\fR Skip the confirmation prompt .TP \fB\-\-prompt\-secrets\fR Prompt securely for missing bootstrap secret inputs .TP \fB\-h, \-\-help\fR Print help \fBArguments:\fR .PP .TP \fB\fR Only apply these targets \fBExamples:\fR .PP .PP .RS 4 mise dot apply mise dot apply \-\-dry\-run mise dot apply \-\-force \-\-yes .RE .SH "MISE BOOTSTRAP DOTFILES CAPTURE" Record tracked files before and after an external command Runs the command directly, inheriting its terminal and environment. Keeps a linked checkpoint pair, including when the command fails or changes no files. Capture failures warn and never replace the command's exit status. Only tracked files are recorded: package, service, and other system effects are not reversible. Concurrent editor changes are part of the same interval. .PP \fBUsage:\fR mise bootstrap dotfiles capture [OPTIONS] ... .PP \fBOptions:\fR .PP .TP \fB\-\-label\fR \fI