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 tasks 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> — Change directory before running command

• -E --env <ENV> — Set the environment for loading mise.<ENV>.toml

• -j --jobs <JOBS> — How many jobs to run in parallel; values below 1 are treated as 1 [default: 8]

  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 — Read/write directly to stdin/stdout/stderr instead of by line

• --locked — 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

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

Flags

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

  Can also use MISE_NO_CONFIG=1

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

  Can also use MISE_NO_ENV=1

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

  Can also use 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 a tool version
• mise install-into — Install a tool version to a specific path
• mise uninstall — Remove installed tool versions
• mise unuse — Remove tool requests from configuration 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 — Resolve the latest matching version request for a tool
• 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 — Display the installation path for a tool
• mise which — Show the path a tool's executable resolves to
• mise bin-paths — List all the active runtime bin paths
• mise registry — List registry shorthand names and their backends
• mise search — Search for tools in the registry
• mise backends — Manage backends
• mise link — Symlink a tool version into mise
• mise sync — Synchronize tools from other version managers with mise
• mise prune — Delete unused versions of tools
• mise reshim — Create shims for executables provided by installed tools
• mise tool-stub — Execute a tool stub
• mise packslip — The signers mise accepts packslips from

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 new shell with the mise environment built from the current configuration
• mise env — Print the environment for the current configuration
• mise exec — Execute a command with tool(s) set
• mise shell — Set a tool version for the current shell session
• mise set — Set environment variables in mise.toml
• mise unset — Remove environment variable(s) from the config file
• mise shell-alias — Manage shell aliases
• mise tool-alias — Manage tool version aliases
• 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 task(s) and rerun them when files change
• mise deps — [experimental] Manage project dependencies
• mise generate — Generate files for various tools/services

Machine setup and images

• mise bootstrap — Set up a machine from the current configuration
• mise oci — [experimental] Build OCI container images from a mise.toml

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 mise installation for possible problems
• mise cache — Manage the mise cache
• mise version — Display the version of mise
• mise self-update — Update mise itself
• mise implode — Remove the mise CLI and all related data

Integrations and community

• mise mcp — Run the Model Context Protocol server over stdin/stdout
• mise skills — Agent skills the active tools ship, from their packslips
• 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

Other commands

• mise plugins — Manage plugins
• mise test-tool — Test that a tool installs and runs
• mise token — Display git provider tokens mise will use