Back to Mise

`mise`

docs/cli/index.md

2026.9.27.2 KB
Original Source
<!-- @generated by usage-cli from usage spec -->

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

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

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