/usr/bin/mise

mise installs the development tools your projects need, sets their environment          ▄▄  ▄▄▄  ▄▄
variables, and runs their tasks.                                                       ▟  ▙▟   ▙▟  ▙
                                                                                       ▜▄▄▄▄▄▄▄▄▄▄▄▛
You declare tools, environment variables, and tasks in mise.toml. `mise use <TOOL>`     ▀▀▀▀▀▀▀▀▀▀▀
installs a tool and adds it to the project's mise.toml, `mise install` installs          ▗▄▄▄▄▄▄▄▖
everything the config requests, and `mise run <TASK>` runs a task. Docs:                 ▌ ▀   ▔ ▐
https://mise.jdx.dev                                                                     ▝▄ ▀▄▀ ▄▘

Usage: mise [FLAGS] [TASK] [SUBCOMMAND]

Commands:
  activate      Print the script to activate mise in an interactive shell
  backends      Manage backends [aliases: b, backend, backend-list]
  bin-paths     List the bin directories of the active tools
  bootstrap     Set up this machine from your mise config [aliases: bs]
  cache         Manage the mise cache
  completion    Generate shell completions [aliases: complete, completions]
  config        Manage config files [aliases: cfg, toml]
  daemons       [experimental] Manage project daemons with pitchfork [aliases:
                daemon]
  deactivate    Print the script to disable mise in the current shell session
  deps          [experimental] Manage project dependencies [aliases: dep, prepare]
  doctor        Check your mise setup for problems [aliases: dr]
  dotfiles      Deploy, track, and sync dotfiles [aliases: dot]
  edit          Edit mise.toml interactively
  en            Start a subshell with mise's tools and environment
  env           Print the environment for the current configuration [aliases: e]
  exec          Run a command with mise's tools and environment [aliases: x]
  fmt           Format mise TOML configuration
  generate      Generate project files such as CI workflows, git hooks, and scripts
                [aliases: gen, g]
  implode       Remove the mise CLI and all related data
  install       Install the tools in your config, or specific tool versions
                [aliases: i]
  install-into  Install a tool version into a directory outside mise
  installs      [experimental] Inspect and choose identity-layout installations
  latest        Print the latest version that matches a version request
  link          Symlink a tool version into mise [aliases: ln]
  lock          Create or refresh lockfile versions, checksums, and download URLs
  ls            List installed and active tool versions [aliases: list]
  ls-remote     List tool versions available to install [aliases: list-all,
                list-remote]
  lsp           Run the language server for mise config files over stdin/stdout
  mcp           Run the Model Context Protocol server over stdin/stdout
  oci           [experimental] Build, push, and run OCI images of a project's tools
  outdated      Show outdated tool versions
  packslip      Inspect and reset the signers mise has pinned for packslip tools
  patrons       Show the individuals supporting mise as Patron-tier members
  plugins       Manage plugins [aliases: p, plugin, plugin-list]
  prune         Delete tool versions that nothing uses
  registry      List registry shorthand names and their backends
  reshim        Create shims for executables provided by installed tools
  run           Run tasks and their dependencies [aliases: r]
  search        Search for available tools
  secrets       [experimental] Inspect the project's secrets source
  self-update   Update mise itself
  set           Set, show, or list environment variables in mise.toml [aliases: ev,
                env-vars]
  settings      Manage settings
  shell         Set a tool version for the current shell session [aliases: sh]
  shell-alias   Manage shell aliases
  skills        List and link the agent skills that active tools ship [aliases:
                skill]
  sponsors      Show the companies sponsoring mise and the jdx.dev open source tools
  ssh           Open an SSH session, optionally borrowing read-only GitHub access
  sync          Use tool versions installed by other version managers
  tasks         Manage tasks [aliases: t, task]
  test-tool     Test that a tool installs and runs
  token         Show which Git provider token mise uses
  tool          Show information about a tool
  tool-alias    Manage tool backend and version aliases [aliases: alias, aliases]
  tool-stub     Run a tool stub file
  trust         Mark a config file as trusted
  uninstall     Remove installed tool versions
  unset         Remove environment variables from mise.toml
  untrust       Remove explicit trust for a config
  unuse         Remove tool requests from config files and prune unused
                installations [aliases: rm, remove]
  upgrade       Upgrade outdated tools [aliases: up]
  use           Install a tool and add it to configuration [aliases: u]
  vars          List, set, and ask for config vars
  version       Show the version of mise [aliases: v]
  watch         Run tasks and rerun them when files change [aliases: w]
  where         Show the install directory of a tool version
  which         Show the path a tool's executable resolves to
  help          Print this message or the help of the given subcommand(s)

Arguments:
  [TASK]  Task to run

          Shorthand for `mise run <TASK>`.

Flags:
  -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.
                     [env: MISE_JOBS]
  -q, --quiet        Suppress non-error messages
                     [env: MISE_QUIET]
  -v, --verbose      Show extra output (use -vv for even more)
  -y, --yes          Answer yes to all confirmation prompts
      --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`.
      --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
  -h, --help         Print help

Examples:
    Install node 24 and add it to the project's mise.toml
    $ mise use node@24

    Make node 24 your global default
    $ mise use -g node@24

    Install every tool the config requests
    $ mise install

    Run a command with the project's tools on PATH
    $ mise x -- npm install

    Run a command with a tool that is not in the config
    $ mise x python@3.13 -- python app.py

    Add an environment variable to mise.toml
    $ mise set NODE_ENV=production

    Run the build task
    $ mise run build

    Rerun the build task when its sources change
    $ mise watch build

    Choose tools to upgrade from a menu
    $ mise upgrade --interactive

    Turn off color in the global config
    $ mise settings color=0

Author: Jeff Dickey <@jdx>