mise

Author: Jeff Dickey <@jdx>

Usage: mise [FLAGS] [COMMAND | TASK] [ARGS]…

Use mise COMMAND --help for the help shipped with your installed version. Put mise flags before a task name; arguments after the name are passed to that task. Square brackets mark optional input, angle brackets mark required input, and … means the argument can repeat. Do not type those notation characters.

Arguments

• [TASK] — Task to run

  Shorthand for mise run <TASK>.

Global Flags

These flags provide shared context. A command can define its own flag with the same name, so consult that command's page for placement and meaning. Effect labels describe the command's intended operation; configuration evaluation, caches, and required tool installation can still have side effects. They are not sandbox guarantees.

• -C --cd <DIR> — Run as if mise were started in DIR

• -E --env <ENV> — Load the mise.<ENV>.toml config files (same as MISE_ENV)

  Repeat the flag or separate names with commas to load several environments.

• -j --jobs <JOBS> — How many jobs to run in parallel; defaults to the jobs setting

  Values below 1 are treated as 1.

  Environment Variable: MISE_JOBS

• -q --quiet — Suppress non-error messages

  Environment Variable: MISE_QUIET

• -v --verbose — Show extra output (use -vv for even more)

• -y --yes — Answer yes to all confirmation prompts

• --raw — Connect tasks and install commands directly to the terminal

  Commands then run one at a time. Same as MISE_RAW=1 or the raw setting.

• --locked — Require download URLs from the lockfile when installing

  Installing fails when the lockfile has no pre-resolved URL for a tool on the current platform, so mise does not call the GitHub or aqua registry APIs to find one. Same as MISE_LOCKED=1 or the locked setting.

• --silent — Suppress all task output and mise non-error messages

Flags

• --no-config — Do not load any config files

  Same as MISE_NO_CONFIG=1.

• --no-env — Do not load environment variables from config files

  Same as MISE_NO_ENV=1.

• --no-hooks — Do not run hooks from config files

  Same as MISE_NO_HOOKS=1.

• -h --help — Print help

Subcommands

Choose a command family below. Its page lists the available subcommands.

Install and inspect tools

• mise use — Install a tool and add it to configuration
• mise install — Install the tools in your config, or specific tool versions
• mise install-into — Install a tool version into a directory outside mise
• mise installs — [experimental] Inspect and choose identity-layout installations
• mise uninstall — Remove installed tool versions
• mise unuse — Remove tool requests from config files and prune unused installations
• mise upgrade — Upgrade outdated tools
• mise outdated — Show outdated tool versions
• mise lock — Create or refresh lockfile versions, checksums, and download URLs
• mise latest — Print the latest version that matches a version request
• mise ls — List installed and active tool versions
• mise ls-remote — List tool versions available to install
• mise tool — Show information about a tool
• mise where — Show the install directory of a tool version
• mise which — Show the path a tool's executable resolves to
• mise bin-paths — List the bin directories of the active tools
• mise registry — List registry shorthand names and their backends
• mise search — Search for available tools
• mise backends — Manage backends
• mise link — Symlink a tool version into mise
• mise sync — Use tool versions installed by other version managers
• mise prune — Delete tool versions that nothing uses
• mise reshim — Create shims for executables provided by installed tools
• mise tool-stub — Run a tool stub file
• mise packslip — Inspect and reset the signers mise has pinned for packslip tools

Shell and environment

• mise activate — Print the script to activate mise in an interactive shell
• mise deactivate — Print the script to disable mise in the current shell session
• mise completion — Generate shell completions
• mise en — Start a subshell with mise's tools and environment
• mise env — Print the environment for the current configuration
• mise exec — Run a command with mise's tools and environment
• mise shell — Set a tool version for the current shell session
• mise set — Set, show, or list environment variables in mise.toml
• mise unset — Remove environment variables from mise.toml
• mise vars — List, set, and ask for config vars
• mise shell-alias — Manage shell aliases
• mise tool-alias — Manage tool backend and version aliases
• mise secrets — [experimental] Inspect the project's secrets source
• mise token — Show which Git provider token mise uses
• mise ssh — Open an SSH session, optionally borrowing read-only GitHub access

Tasks and project automation

• mise run — Run tasks and their dependencies
• mise tasks — Manage tasks
• mise watch — Run tasks and rerun them when files change
• mise deps — [experimental] Manage project dependencies
• mise daemons — [experimental] Manage project daemons with pitchfork
• mise generate — Generate project files such as CI workflows, git hooks, and scripts

Machine setup and images

• mise bootstrap — Set up this machine from your mise config
• mise dotfiles — Deploy, track, and sync dotfiles
• mise oci — [experimental] Build, push, and run OCI images of a project's tools

Configuration and diagnostics

• mise config — Manage config files
• mise edit — Edit mise.toml interactively
• mise fmt — Format mise TOML configuration
• mise settings — Manage settings
• mise trust — Mark a config file as trusted
• mise untrust — Remove explicit trust for a config
• mise doctor — Check your mise setup for problems
• mise cache — Manage the mise cache
• mise version — Show the version of mise
• mise self-update — Update mise itself
• mise implode — Remove the mise CLI and all related data

Plugins

• mise plugins — Manage plugins
• mise test-tool — Test that a tool installs and runs

Integrations and community

• mise mcp — Run the Model Context Protocol server over stdin/stdout
• mise skills — List and link the agent skills that active tools ship
• mise patrons — Show the individuals supporting mise as Patron-tier members
• mise sponsors — Show the companies sponsoring mise and the jdx.dev open source tools