MISE(1)

NAME
mise - Dev tools, env vars, and tasks in one CLI

SYNOPSIS
mise [OPTIONS] [<TASK>] [<TASK_ARGS>] ... [<TASK_ARGS_LAST>] ... [COMMAND]

DESCRIPTION
mise prepares your development environment before each command runs. https://github.com/jdx/mise

OPTIONS

-c, --continue-on-error
    Continue running tasks even if one fails

-C, --cd <DIR>
    Change directory before running command

-E, --env <ENV>
    Set the environment for loading `mise.<ENV>.toml`

-f, --force
    Force the operation

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

-n, --dry-run
    Dry run, don't actually do anything

-P, --profile <PROFILE>
    Set the profile (environment)

-q, --quiet
    Suppress non-error messages
    Environment: MISE_QUIET

-s, --shell <SHELL>

-t, --tool <TOOL@VERSION>
    Tool(s) to run in addition to what is in mise.toml files e.g.: node@20 python@3.10

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

-V, --version

-y, --yes
    Answer yes to all confirmation prompts

--debug
    Sets log level to debug

--log-level <LEVEL>

--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`

--no-timings
    Hides elapsed time after each task completes Default to always hide with `MISE_TASK_TIMINGS=0`

--output <OUTPUT>

--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

--timings
    Shows elapsed time after each task completes Default to always show with `MISE_TASK_TIMINGS=1`

--trace
    Sets log level to trace

-h, --help
    Print help

ARGUMENTS

<TASK>
    Task to run. Shorthand for `mise tasks run <TASK>`.

<TASK_ARGS>
    Task arguments

COMMANDS

activate
    Initializes mise in the current shell session

tool-alias
    Manage tool version aliases.
    Aliases: alias, aliases

tool-alias get
    Show an alias for a tool

tool-alias ls
    List tool version aliases
    Aliases: list

tool-alias set
    Add/update an alias for a tool/backend
    Aliases: add, create

tool-alias unset
    Clears an alias for a tool/backend
    Aliases: rm, remove, delete, del

backends
    Manage backends
    Aliases: b, backend, backend-list

backends ls
    List built-in backends
    Aliases: list

bin-paths
    List all the active runtime bin paths

bootstrap
    Set up a machine for the current config in one command
    Aliases: bs

bootstrap accounts
    Manage Linux users and groups from `[bootstrap.users]` and `[bootstrap.groups]`

bootstrap accounts apply
    Apply configured Linux users and groups

bootstrap accounts status
    Show configured Linux user and group state

bootstrap compose
    Manage Docker Compose projects from `[bootstrap.compose]`

bootstrap compose apply
    Apply configured Docker Compose project state

bootstrap compose status
    Show configured Docker Compose project state

bootstrap dotfiles
    Manage dotfiles from `[dotfiles]`

bootstrap dotfiles add
    Add or update dotfiles in `[dotfiles]`

bootstrap dotfiles apply
    Apply dotfiles from `[dotfiles]`

bootstrap dotfiles diff
    Show the changes needed to apply dotfiles from `[dotfiles]`

bootstrap dotfiles edit
    Edit a managed dotfile source

bootstrap dotfiles status
    Show the status of dotfiles from `[dotfiles]`
    Aliases: ls

bootstrap dotfiles unapply
    Remove dotfiles applied from `[dotfiles]`

bootstrap files
    Manage privileged files and directories from `[bootstrap.files]` and `[bootstrap.directories]`

bootstrap files apply
    Apply configured privileged files and directories

bootstrap files status
    Show configured privileged file and directory state

bootstrap firewall
    Manage the Linux host firewall from `[bootstrap.linux.firewall]`

bootstrap firewall apply
    Apply the configured Linux host firewall

bootstrap firewall status
    Show configured Linux host firewall state

bootstrap linux
    Manage Linux bootstrap config from `[bootstrap.linux]`

bootstrap linux systemd-units
    Manage systemd user services from `[bootstrap.linux.systemd.units]`
    Aliases: systemd

bootstrap linux systemd-units apply

bootstrap linux systemd-units status

bootstrap macos
    Manage macOS bootstrap config from `[bootstrap.macos]`

bootstrap macos defaults
    Manage macOS defaults from `[bootstrap.macos.defaults]`

bootstrap macos defaults apply

bootstrap macos defaults status

bootstrap macos launchd-agents
    Manage macOS LaunchAgents from `[bootstrap.macos.launchd.agents]`
    Aliases: launchd

bootstrap macos launchd-agents apply

bootstrap macos launchd-agents status

bootstrap mise-shell-activate
    Manage mise shell activation from `[bootstrap.mise_shell_activate]`
    Aliases: shell

bootstrap mise-shell-activate apply

bootstrap mise-shell-activate status

bootstrap packages
    Manage bootstrap system packages from `[bootstrap.packages]`

bootstrap packages apply
    Apply system packages from `[bootstrap.packages]`
    Aliases: i, install

bootstrap packages brew
    Manage Homebrew taps used by bootstrap packages

bootstrap packages brew tap
    Add a Homebrew tap URL to [bootstrap.brew.taps]

bootstrap packages brew untap
    Remove Homebrew tap URLs from [bootstrap.brew.taps]
    Aliases: remove, rm

bootstrap packages import
    Import installed system packages into `[bootstrap.packages]`

bootstrap packages prune
    Prune installed system packages no longer declared in `[bootstrap.packages]`

bootstrap packages status
    Show the status of system packages from `[bootstrap.packages]`
    Aliases: ls

bootstrap packages upgrade
    Upgrade installed bootstrap packages from `[bootstrap.packages]`
    Aliases: up

bootstrap packages use
    Add bootstrap packages to [bootstrap.packages] and install them
    Aliases: u

bootstrap plan
    Show the changes declarative bootstrap resources would make

bootstrap plugins
    Manage package manager plugins declared in `[bootstrap.plugins]`

bootstrap plugins apply

bootstrap plugins status

bootstrap remote
    Bootstrap one or more machines over OpenSSH

bootstrap repos
    Manage git repo checkouts from `[bootstrap.repos]`

bootstrap repos apply

bootstrap repos exec

bootstrap repos status

bootstrap repos update

bootstrap secrets
    Inspect bootstrap secret inputs without revealing their values

bootstrap secrets status
    Show whether declared bootstrap secret inputs are available

bootstrap services
    Manage Linux system services from `[bootstrap.services]`

bootstrap services apply
    Apply configured Linux system service state

bootstrap services status
    Show configured Linux system service state

bootstrap status
    Show the aggregate bootstrap status
    Aliases: ls

bootstrap user
    Manage current-user bootstrap settings from `[bootstrap.user]`

bootstrap user apply

bootstrap user status

cache
    Manage the mise cache

cache clear
    Deletes all cache files in mise
    Aliases: c, clean

cache path
    Show the cache directory path
    Aliases: dir

cache prune
    Removes stale mise cache files
    Aliases: p

cache task
    Inspect output cache entries for a task

completion
    Generate shell completions
    Aliases: complete, completions

config
    Manage config files
    Aliases: cfg, toml

config get
    Display the value of a setting in a mise.toml file

config ls
    List config files currently in use
    Aliases: list

config set
    Set the value of a setting in a mise.toml file

deactivate
    Disable mise for current shell session

doctor
    Check mise installation for possible problems
    Aliases: dr

doctor path
    Print the current PATH entries mise is providing
    Aliases: paths

en  Starts a new shell with the mise environment built from the current configuration

env Exports env vars to activate mise a single time
    Aliases: e

exec
    Execute a command with tool(s) set
    Aliases: x

fmt Formats mise.toml

generate
    Generate files for various tools/services
    Aliases: gen, g

generate config
    Generate a mise.toml file

generate devcontainer
    Generate a devcontainer to execute mise

generate git-pre-commit
    Generate a git pre-commit hook
    Aliases: pre-commit

generate github-action
    Generate a GitHub Action workflow file

generate install-script
    Generate a script to download+execute mise

generate task-docs
    Generate documentation for tasks in a project

generate task-stubs
    Generates shims to run mise tasks

generate tool-stub
    Generate a tool stub for HTTP-based tools

implode
    Removes mise CLI and all related data

edit
    Edit mise.toml interactively

install
    Install a tool version
    Aliases: i

install-into
    Install a tool version to a specific path

latest
    Gets the latest available version for a plugin

link
    Symlinks a tool version into mise
    Aliases: ln

lock
    Update lockfile checksums and URLs for all specified platforms

ls  List installed and active tool versions
    Aliases: list

ls-remote
    List runtime versions available for install.
    Aliases: list-all, list-remote

mcp Run Model Context Protocol (MCP) server

oci [experimental] Build OCI container images from a mise.toml

oci build
    [experimental] Build an OCI image from the current mise.toml

oci push
    [experimental] Build an OCI image and push it to a registry

oci run
    [experimental] Build an OCI image from the current mise.toml and run a command in it

outdated
    Shows outdated tool versions

patrons
    Show the individuals supporting mise as Patron-tier members

plugins
    Manage plugins
    Aliases: p, plugin, plugin-list

plugins install
    Install a plugin
    Aliases: i, a, add

plugins link
    Symlinks a plugin into mise
    Aliases: ln

plugins ls
    List installed plugins
    Aliases: list

plugins ls-remote
    Aliases: list-remote, list-all

plugins uninstall
    Removes a plugin
    Aliases: remove, rm

plugins update
    Updates a plugin to the latest version
    Aliases: up, upgrade

deps
    [experimental] Manage project dependencies
    Aliases: dep, prepare

deps add
    Add a dependency

deps install
    Install all project dependencies

deps remove
    Remove a dependency

prune
    Delete unused versions of tools

registry
    List available tools to install

reshim
    Creates new shims based on bin paths from currently installed tools.

run Run task(s)
    Aliases: r

search
    Search for tools in the registry

self-update
    Updates mise itself.

set Set environment variables in mise.toml
    Aliases: ev, env-vars

settings
    Manage settings

settings add
    Adds a setting to the configuration file

settings get
    Show a current setting

settings ls
    Show current settings
    Aliases: list

settings set
    Add/update a setting
    Aliases: create

settings unset
    Clears a setting
    Aliases: rm, remove, delete, del

shell
    Sets a tool version for the current session.
    Aliases: sh

shell-alias
    Manage shell aliases.

shell-alias get
    Show the command for a shell alias

shell-alias ls
    List shell aliases
    Aliases: list

shell-alias set
    Add/update a shell alias
    Aliases: add, create

shell-alias unset
    Removes a shell alias
    Aliases: rm, remove, delete, del

sponsors
    Show the companies sponsoring mise and the jdx.dev open source tools

sync
    Synchronize tools from other version managers with mise

sync node
    Symlinks all tool versions from an external tool into mise

sync python
    Symlinks all tool versions from an external tool into mise

sync ruby
    Symlinks all ruby tool versions from an external tool into mise

tasks
    Manage tasks
    Aliases: t, task

tasks add
    Create a new task

tasks deps
    Display a tree visualization of a dependency graph

tasks edit
    Edit a task with $EDITOR

tasks graph
    [experimental] Inspect the workspace project graph

tasks info
    Get information about a task

tasks ls
    List available tasks to execute

tasks run
    Run task(s)
    Aliases: r

tasks validate
    Validate tasks for common errors and issues

test-tool
    Test a tool installs and executes

token
    Display git provider tokens mise will use

token forgejo
    Display the Forgejo token mise will use for a given host

token github
    Display the GitHub token mise will use for a given host

token gitlab
    Display the GitLab token mise will use for a given host

tool
    Gets information about a tool

tool-stub
    Execute a tool stub

trust
    Marks a config file as trusted

uninstall
    Removes installed tool versions

unset
    Remove environment variable(s) from the config file.

untrust
    Remove explicit trust for a config

unuse
    Removes installed tool versions from mise.toml
    Aliases: rm, remove

upgrade
    Upgrades outdated tools
    Aliases: up

use Installs a tool and adds the version to mise.toml.
    Aliases: u

version
    Display the version of mise
    Aliases: v

watch
    Run task(s) and watch for changes to rerun it
    Aliases: w

where
    Display the installation path for a tool

which
    Shows the path that a tool's bin points to.

MISE ACTIVATE
Initializes mise in the current shell session This should go into your shell's rc file or login shell. Otherwise, it will only take effect in the current session. (e.g. ~/.zshrc, ~/.zprofile, ~/.zshenv, ~/.bashrc, ~/.bash_profile, ~/.profile, ~/.config/fish/config.fish, or $PROFILE for powershell) Typically, this can be added with something like the following:
    echo 'eval "$(mise activate zsh)"' >> ~/.zshrc However, this requires that "mise" is in your PATH. If it is not, you need to specify the full path like this:
    echo 'eval "$(/path/to/mise activate zsh)"' >> ~/.zshrc Customize status output with `status` settings.

Usage: mise activate [OPTIONS] [<SHELL_TYPE>]

Options:

-q, --quiet
    Suppress non-error messages

-s, --shell <SHELL>
    Shell type to generate the script for

--no-hook-env
    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.

--shims
    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

--status
    Show "mise: <TOOL>@<VERSION>" message when changing directories

-h, --help
    Print help Arguments:

<SHELL_TYPE>
    Shell type to generate the script for

MISE TOOL-ALIAS
Manage tool version aliases.

Usage: mise tool-alias [OPTIONS] [COMMAND]

Options:

-p, --tool <TOOL>
    Filter aliases by tool

--no-header
    Don't show table header

-h, --help
    Print help

MISE TOOL-ALIAS GET
Show an alias for a tool This is the contents of a tool_alias.<TOOL> entry in ~/.config/mise/config.toml

Usage: mise tool-alias get [OPTIONS] <TOOL> <ALIAS>

Options:

-h, --help
    Print help Arguments:

<TOOL>
    The tool to show the alias for

<ALIAS>
    The alias to show

MISE TOOL-ALIAS LS
List tool version aliases Shows the aliases that can be specified. These can come from user config or from plugins in `bin/list-aliases`. For user config, aliases are defined like the following in `~/.config/mise/config.toml`:
    [tool_alias.node.versions]
    lts = "22.0.0"

Usage: mise tool-alias ls [OPTIONS] [<TOOL>]

Options:

--no-header
    Don't show table header

-h, --help
    Print help Arguments:

<TOOL>
    Show aliases for <TOOL>

MISE TOOL-ALIAS SET
Add/update an alias for a tool/backend This modifies the contents of ~/.config/mise/config.toml

Usage: mise tool-alias set [OPTIONS] <TOOL> <ALIAS> [<VALUE>]

Options:

-h, --help
    Print help Arguments:

<TOOL>
    The tool/backend to set the alias for

<ALIAS>
    The alias to set

<VALUE>
    The value to set the alias to

MISE TOOL-ALIAS UNSET
Clears an alias for a tool/backend This modifies the contents of ~/.config/mise/config.toml

Usage: mise tool-alias unset [OPTIONS] <TOOL> [<ALIAS>]

Options:

-h, --help
    Print help Arguments:

<TOOL>
    The tool/backend to remove the alias from

<ALIAS>
    The alias to remove

MISE BACKENDS
Manage backends

Usage: mise backends [OPTIONS] [COMMAND]

Options:

-h, --help
    Print help

MISE BACKENDS LS
List built-in backends

Usage: mise backends ls [OPTIONS]

Options:

-h, --help
    Print help

MISE BIN-PATHS
List all the active runtime bin paths

Usage: mise bin-paths [OPTIONS] [<TOOL@VERSION>] ...

Options:

--bin-names
    Output executable names instead of bin directories

-J, --json
    Output executable entries in JSON format (implies --bin-names)

-h, --help
    Print help Arguments:

<TOOL@VERSION>
    Tool(s) to look up e.g.: ruby@3

MISE BOOTSTRAP
Set up a machine for the current config in one command Runs the bootstrap steps for the current config in order: 0. `mise bootstrap accounts apply` — converge `[bootstrap.users]` and
   `[bootstrap.groups]` (Linux) 1. `mise bootstrap plugins apply` — install `[bootstrap.plugins]`
   1.7. `[bootstrap.hooks.pre-packages]` — optional setup hook 2. Install built-in-manager entries from `[bootstrap.packages]` 3. `mise bootstrap files apply` — converge `[bootstrap.files]` and
   `[bootstrap.directories]` 4. `mise bootstrap services apply` — converge `[bootstrap.services]`
   systemd system services (Linux) 5. `mise bootstrap firewall apply` — converge `[bootstrap.linux.firewall]`
   host firewall policy and rules (Linux) 6. `mise bootstrap compose apply` — converge `[bootstrap.compose]`
   Docker Compose projects 7. `mise bootstrap repos apply` — clone/converge `[bootstrap.repos]`
   surrounded by `pre-repos`/`post-repos` hooks 8. `mise bootstrap dotfiles apply` — apply dotfiles from `[dotfiles]`
   surrounded by `pre-dotfiles`/`post-dotfiles` hooks 9. `mise bootstrap mise-shell-activate apply` — configure shell activation
   from `[bootstrap.mise_shell_activate]` 10. `mise bootstrap macos defaults apply` — write
    `[bootstrap.macos.defaults]` entries (macOS)
    surrounded by `pre-defaults`/`post-defaults` hooks 11. `mise bootstrap macos launchd-agents apply` — install/load
    `[bootstrap.macos.launchd.agents]` 12. `mise bootstrap linux systemd-units apply` — install/start
    `[bootstrap.linux.systemd.units]` 13. `mise bootstrap user apply` — set `[bootstrap.user].login_shell`
    (Unix)
    surrounded by `pre-user`/`post-user` hooks 14. `mise install` — install missing tools from `[tools]`
    surrounded by `pre-tools`/`post-tools` hooks; package-plugin entries
    from `[bootstrap.packages]` install afterward, followed by
    `[bootstrap.hooks.post-packages]` 15. `mise run bootstrap` — if a task named `bootstrap` is defined 16. `[bootstrap.hooks.final]` — optional final hook The declarative steps converge — anything already in its desired state is skipped, so re-running is safe. The `bootstrap` task runs on every invocation; keep it idempotent. Use it for any project-specific setup that doesn't fit the declarative sections (seeding databases, auth flows, etc.) — it runs with the installed tools on PATH. Use `--skip <part>` to skip named parts, or `--only <part>` to run just named parts. Both flags can be repeated or comma-separated, but they cannot be used together.

Usage: mise bootstrap [OPTIONS] [COMMAND]

Options:

--from <GIT_URL>
    Clone a git repository and bootstrap from its configuration

--from-dir <DIR>
    Directory used for the repository cloned by --from

-n, --dry-run
    Print what would happen without installing anything

-y, --yes
    Skip confirmation prompts

--skip-dirty
    Skip configured repos with local changes instead of failing

--force-dotfiles
    Overwrite existing files that conflict with whole-file dotfile entries

--only <ONLY>
    Run only one or more bootstrap parts Can be passed multiple times or as a comma-separated list. Cannot be used with `--skip`.

--prompt-secrets
    Prompt securely for missing bootstrap secret inputs

--skip <SKIP>
    Skip one or more bootstrap parts Can be passed multiple times or as a comma-separated list.

--update
    Refresh package manager metadata and update configured repos

-h, --help
    Print help

MISE BOOTSTRAP ACCOUNTS
Manage Linux users and groups from `[bootstrap.users]` and `[bootstrap.groups]`

Usage: mise bootstrap accounts [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP ACCOUNTS APPLY
Apply configured Linux users and groups

Usage: mise bootstrap accounts apply [OPTIONS]

Options:

-n, --dry-run
    Print what would change without changing anything

-y, --yes
    Skip the confirmation prompt

-h, --help
    Print help

MISE BOOTSTRAP ACCOUNTS STATUS
Show configured Linux user and group state

Usage: mise bootstrap accounts status [OPTIONS]

Options:

-J, --json
    Output in JSON format

--missing
    Exit with code 1 when any account is not converged

-h, --help
    Print help

MISE BOOTSTRAP COMPOSE
Manage Docker Compose projects from `[bootstrap.compose]`

Usage: mise bootstrap compose [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP COMPOSE APPLY
Apply configured Docker Compose project state

Usage: mise bootstrap compose apply [OPTIONS]

Options:

-n, --dry-run
    Print what would change without changing anything

-y, --yes
    Skip the confirmation prompt

-h, --help
    Print help

MISE BOOTSTRAP COMPOSE STATUS
Show configured Docker Compose project state

Usage: mise bootstrap compose status [OPTIONS]

Options:

-J, --json
    Output in JSON format

--missing
    Exit with code 1 when any Compose project is not converged

-h, --help
    Print help

MISE BOOTSTRAP DOTFILES
Manage dotfiles from `[dotfiles]`

Usage: mise bootstrap dotfiles [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

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.

Usage: mise bootstrap dotfiles add [OPTIONS] [<TARGET>] ...

Options:

--changed
    Update the sources of every changed file managed in copy mode

-f, --force
    Overwrite existing sources without prompting

-g, --global
    Write to the global config

-l, --local
    Write to the local config instead of the global config

-m, --mode <MODE>
    Dotfile mode to write

-n, --dry-run
    Print the config/source updates without writing anything

--no-apply
    Add the entry without applying it

-p, --path <PATH>
    Write to this config file or directory

-s, --source <PATH>
    Source path to use for a single target

-y, --yes
    Skip the confirmation prompt

-h, --help
    Print help Arguments:

<TARGET>
    Targets to add or update

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.

Usage: mise bootstrap dotfiles apply [OPTIONS] [<TARGET>] ...

Options:

-f, --force
    Overwrite existing files that conflict with whole-file dotfile entries

-n, --dry-run
    Print the actions that would run without writing anything

-y, --yes
    Skip the confirmation prompt

-h, --help
    Print help Arguments:

<TARGET>
    Only apply these targets

MISE BOOTSTRAP DOTFILES DIFF
Show the changes needed to apply dotfiles from `[dotfiles]`

Usage: mise bootstrap dotfiles diff [OPTIONS] [<TARGET>] ...

Options:

-h, --help
    Print help Arguments:

<TARGET>
    Only show these targets

MISE BOOTSTRAP DOTFILES EDIT
Edit a managed dotfile source

Usage: mise bootstrap dotfiles edit [OPTIONS] <TARGET>

Options:

--apply
    Apply this target after the editor exits

-m, --mode <MODE>
    Dotfile mode to use if the target is not yet managed

-s, --source <PATH>
    Source path to use if the target is not yet managed

-y, --yes
    Skip the confirmation prompt when adding an unmanaged target

-h, --help
    Print help Arguments:

<TARGET>
    Target to edit

MISE BOOTSTRAP DOTFILES STATUS
Show the status of dotfiles from `[dotfiles]`

Usage: mise bootstrap dotfiles status [OPTIONS] [<TARGET>] ...

Options:

-J, --json
    Output in JSON format

--missing
    Exit with code 1 if any configured dotfiles are not in their desired state (missing, source missing, differs)

-h, --help
    Print help Arguments:

<TARGET>
    Only show these targets

MISE BOOTSTRAP DOTFILES UNAPPLY
Remove dotfiles applied from `[dotfiles]` Removes configured whole-file entries and edits while preserving files mise cannot identify as managed. Modified copies, templates, and plain-line edits require `--force`.

Usage: mise bootstrap dotfiles unapply [OPTIONS] [<TARGET>] ...

Options:

-f, --force
    Remove modified or otherwise ambiguous managed files and lines

-n, --dry-run
    Print the actions that would run without writing anything

-y, --yes
    Skip the confirmation prompt

-h, --help
    Print help Arguments:

<TARGET>
    Only unapply these targets

MISE BOOTSTRAP FILES
Manage privileged files and directories from `[bootstrap.files]` and `[bootstrap.directories]`

Usage: mise bootstrap files [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP FILES APPLY
Apply configured privileged files and directories

Usage: mise bootstrap files apply [OPTIONS]

Options:

-n, --dry-run
    Print what would change without changing anything

-y, --yes
    Skip the confirmation prompt

--prompt-secrets
    Prompt securely for missing bootstrap secret inputs

-h, --help
    Print help

MISE BOOTSTRAP FILES STATUS
Show configured privileged file and directory state

Usage: mise bootstrap files status [OPTIONS]

Options:

-J, --json
    Output in JSON format

--missing
    Exit with code 1 when any resource is not converged

--prompt-secrets
    Prompt securely for missing bootstrap secret inputs

-h, --help
    Print help

MISE BOOTSTRAP FIREWALL
Manage the Linux host firewall from `[bootstrap.linux.firewall]`

Usage: mise bootstrap firewall [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP FIREWALL APPLY
Apply the configured Linux host firewall

Usage: mise bootstrap firewall apply [OPTIONS]

Options:

-n, --dry-run
    Print what would change without changing anything

-y, --yes
    Skip the confirmation prompt

-h, --help
    Print help

MISE BOOTSTRAP FIREWALL STATUS
Show configured Linux host firewall state

Usage: mise bootstrap firewall status [OPTIONS]

Options:

-J, --json
    Output in JSON format

--missing
    Exit with code 1 when the firewall is not converged

-h, --help
    Print help

MISE BOOTSTRAP LINUX
Manage Linux bootstrap config from `[bootstrap.linux]`

Usage: mise bootstrap linux [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP LINUX SYSTEMD-UNITS
Manage systemd user services from `[bootstrap.linux.systemd.units]`

Usage: mise bootstrap linux systemd-units [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP LINUX SYSTEMD-UNITS APPLY
Usage: mise bootstrap linux systemd-units apply [OPTIONS]

Options:

-n, --dry-run
    Print the commands that would run without running them

-y, --yes
    Skip the confirmation prompt

-h, --help
    Print help

MISE BOOTSTRAP LINUX SYSTEMD-UNITS STATUS
Usage: mise bootstrap linux systemd-units status [OPTIONS]

Options:

-J, --json
    Output in JSON format

--missing
    Exit with code 1 if any configured systemd user service is not in its desired state

-h, --help
    Print help

MISE BOOTSTRAP MACOS
Manage macOS bootstrap config from `[bootstrap.macos]`

Usage: mise bootstrap macos [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP MACOS DEFAULTS
Manage macOS defaults from `[bootstrap.macos.defaults]`

Usage: mise bootstrap macos defaults [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP MACOS DEFAULTS APPLY
Usage: mise bootstrap macos defaults apply [OPTIONS]

Options:

-n, --dry-run
    Print the commands that would run without running them

-y, --yes
    Skip the confirmation prompt

-h, --help
    Print help

MISE BOOTSTRAP MACOS DEFAULTS STATUS
Usage: mise bootstrap macos defaults status [OPTIONS]

Options:

-J, --json
    Output in JSON format

--missing
    Exit with code 1 if any configured defaults are not in their desired state

-h, --help
    Print help

MISE BOOTSTRAP MACOS LAUNCHD-AGENTS
Manage macOS LaunchAgents from `[bootstrap.macos.launchd.agents]`

Usage: mise bootstrap macos launchd-agents [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP MACOS LAUNCHD-AGENTS APPLY
Usage: mise bootstrap macos launchd-agents apply [OPTIONS]

Options:

-n, --dry-run
    Print the commands that would run without running them

-y, --yes
    Skip the confirmation prompt

-h, --help
    Print help

MISE BOOTSTRAP MACOS LAUNCHD-AGENTS STATUS
Usage: mise bootstrap macos launchd-agents status [OPTIONS]

Options:

-J, --json
    Output in JSON format

--missing
    Exit with code 1 if any configured LaunchAgent is not in its desired state

-h, --help
    Print help

MISE BOOTSTRAP MISE-SHELL-ACTIVATE
Manage mise shell activation from `[bootstrap.mise_shell_activate]`

Usage: mise bootstrap mise-shell-activate [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP MISE-SHELL-ACTIVATE APPLY
Usage: mise bootstrap mise-shell-activate apply [OPTIONS]

Options:

-n, --dry-run
    Print the actions that would run without writing anything

-y, --yes
    Skip the confirmation prompt

-h, --help
    Print help

MISE BOOTSTRAP MISE-SHELL-ACTIVATE STATUS
Usage: mise bootstrap mise-shell-activate status [OPTIONS]

Options:

-J, --json
    Output in JSON format

--missing
    Exit with code 1 if any configured shell activation is not in its desired state

-h, --help
    Print help

MISE BOOTSTRAP PACKAGES
Manage bootstrap system packages from `[bootstrap.packages]`

Usage: mise bootstrap packages [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP PACKAGES APPLY
Apply system packages from `[bootstrap.packages]` Checks which configured packages are missing and installs them with the system package manager. Built-in system managers may elevate with sudo when not running as root (see `system_packages.sudo`); package plugins never do. Packages can also be given explicitly in `manager:package` form (e.g. `apk:zlib-dev`, `apt:curl`, `brew:jq`); they are installed whether or not they appear in the config. Explicit packages and `--manager` scope the run to packages only. `install` is accepted as an alias for this command.

Usage: mise bootstrap packages apply [OPTIONS] [<PACKAGE>] ...

Options:

-m, --manager <MANAGER>
    Only install packages for this built-in or plugin manager

-n, --dry-run
    Print the commands that would run without running them

-y, --yes
    Skip the confirmation prompt

--update
    Refresh package manager metadata first (apk: `--update-cache`, apt: `apt-get update`)

-h, --help
    Print help Arguments:

<PACKAGE>
    Packages in `manager:package` form; defaults to everything configured in [bootstrap.packages]

MISE BOOTSTRAP PACKAGES BREW
Manage Homebrew taps used by bootstrap packages These commands edit `[bootstrap.brew.taps]` so tapped formulae and casks can be fetched directly by mise without a Homebrew installation.

Usage: mise bootstrap packages brew [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP PACKAGES BREW TAP
Add a Homebrew tap URL to [bootstrap.brew.taps]

Usage: mise bootstrap packages brew tap [OPTIONS] <TAP> [<URL>]

Options:

-l, --local
    Write to the local config instead of the global config

-n, --dry-run
    Print the config change without writing it

-p, --path, --file <PATH>
    Write to this config file or directory

-h, --help
    Print help Arguments:

<TAP>
    Tap name, e.g. `owner/repo`

<URL>
    GitHub URL for the tap. Defaults to https://github.com/<owner>/homebrew-<repo>.git

MISE BOOTSTRAP PACKAGES BREW UNTAP
Remove Homebrew tap URLs from [bootstrap.brew.taps]

Usage: mise bootstrap packages brew untap [OPTIONS] <TAPS> ...

Options:

-l, --local
    Write to the local config instead of the global config

-n, --dry-run
    Print the config change without writing it

-p, --path, --file <PATH>
    Write to this config file or directory

-h, --help
    Print help Arguments:

<TAPS>
    Tap name(s), e.g. `owner/repo`

MISE BOOTSTRAP PACKAGES IMPORT
Import installed system packages into `[bootstrap.packages]` Currently supports Homebrew formulae only. By default, imports linked formulae whose active keg receipt says they were installed on request. Pass `--all` to import every linked formula, including dependencies.

Usage: mise bootstrap packages import [OPTIONS]

Options:

-e, --env <ENV>
    Write to the config file for this environment (mise.<ENV>.toml)

-g, --global
    Write to the global config (~/.config/mise/config.toml)

-m, --manager <MANAGER>
    Only import packages for this manager. Currently only `brew` is supported.
    Default: brew

--all
    Import every linked formula, including dependencies

-n, --dry-run
    Print the config change without writing config

-p, --path, --file <PATH>
    Write to this config file or directory

-h, --help
    Print help

MISE BOOTSTRAP PACKAGES PRUNE
Prune installed system packages no longer declared in `[bootstrap.packages]` Supports Homebrew formulae, conservatively removable mise-owned casks, and packages installed by package plugins that implement `PackageUninstall`. Pruning keeps packages needed by the current config or by trusted, loadable tracked configs. Plugin packages that were already installed before mise first applied them are never claimed or removed.

Usage: mise bootstrap packages prune [OPTIONS]

Options:

-m, --manager <MANAGER>
    Only prune packages for this manager
    Default: brew

-n, --dry-run
    Print what would be removed without deleting anything

-y, --yes
    Skip the confirmation prompt

-h, --help
    Print help

MISE BOOTSTRAP PACKAGES STATUS
Show the status of system packages from `[bootstrap.packages]`

Usage: mise bootstrap packages status [OPTIONS]

Options:

-J, --json
    Output in JSON format

--missing
    Exit with code 1 if any configured packages are not in their desired state

-h, --help
    Print help

MISE BOOTSTRAP PACKAGES UPGRADE
Upgrade installed bootstrap packages from `[bootstrap.packages]` Refreshes package manager metadata and upgrades the configured packages that are already installed: apk/apt/dnf/pacman upgrade to the newest available version (apk, apt, and dnf honor a version pinned in config), brew pours the formula's current bottle and replaces the old keg, brew-cask installs the current cask artifact, flatpak and flatpak-user update applications and runtimes, and mas upgrades App Store apps. Packages that are not installed yet are skipped — use `mise bootstrap packages apply` for those. Packages can also be given explicitly in `manager:package` form.

Usage: mise bootstrap packages upgrade [OPTIONS] [<PACKAGE>] ...

Options:

-m, --manager <MANAGER>
    Only upgrade packages for this built-in or plugin manager

-n, --dry-run
    Print the commands that would run without running them

-y, --yes
    Skip the confirmation prompt

-h, --help
    Print help Arguments:

<PACKAGE>
    Packages in `manager:package` form; defaults to everything configured in [bootstrap.packages]

MISE BOOTSTRAP PACKAGES USE
Add bootstrap packages to [bootstrap.packages] and install them Like `mise use` for tools: writes `"manager:package" = "version"` entries to mise.toml (the local config by default, the global one with `-g`) and then installs whatever is missing. Versions are pinned with `@`: `mise bootstrap packages use apt:curl@8.5.0-2`. Without `@` (or with `@latest`) no pin is written. brew formulae and casks version through their names instead (for example `brew:postgresql@17`, `brew-cask:temurin@17`), where `@` is part of the Homebrew name rather than a mise version selector. mas uses numeric ADAM IDs and does not support pins.

Usage: mise bootstrap packages use [OPTIONS] <PACKAGE> ...

Options:

-e, --env <ENV>
    Write to the config file for this environment (mise.<ENV>.toml)

-g, --global
    Write to the global config (~/.config/mise/config.toml) instead of the local one

-n, --dry-run
    Print the commands that would run without writing config or installing

-p, --path, --file <PATH>
    Write to this config file or directory

-y, --yes
    Skip the confirmation prompt

-h, --help
    Print help Arguments:

<PACKAGE>
    Packages in `manager:package[@version]` form

MISE BOOTSTRAP PLAN
Show the changes declarative bootstrap resources would make

Usage: mise bootstrap plan [OPTIONS]

Options:

-J, --json
    Output a stable machine-readable plan in JSON format

--detailed-exitcode
    Exit 2 when the plan contains changes, 0 when unchanged, and 1 on errors

--prompt-secrets
    Prompt securely for missing bootstrap secret inputs

-h, --help
    Print help

MISE BOOTSTRAP PLUGINS
Manage package manager plugins declared in `[bootstrap.plugins]`

Usage: mise bootstrap plugins [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP PLUGINS APPLY
Usage: mise bootstrap plugins apply [OPTIONS]

Options:

-n, --dry-run
    Print what would happen without installing plugins

-h, --help
    Print help

MISE BOOTSTRAP PLUGINS STATUS
Usage: mise bootstrap plugins status [OPTIONS]

Options:

--missing
    Exit with code 1 if a declared plugin is missing

-h, --help
    Print help

MISE BOOTSTRAP REMOTE
Bootstrap one or more machines over OpenSSH

Usage: mise bootstrap remote [OPTIONS] [<TARGET>] ...

Options:

--all
    Select every configured inventory host

--bootstrap-command <COMMAND>
    Explicit remote shell command that installs mise and places it on PATH

--connect-timeout <CONNECT_TIMEOUT>
    SSH connection timeout in seconds
    Default: 10

--copy-link <PATH>
    Dereference one source-relative symbolic link; repeat for multiple links

--copy-links
    Dereference every symbolic link in the source archive

--exclude <PATTERN>
    Additional archive pattern to exclude; repeat for multiple patterns

--fail-fast
    Stop after the first failed target

--force-dotfiles
    Allow remote dotfile conflicts to be replaced

--host <[USER@]HOST>
    Ad-hoc SSH destination (`[user@]host`); repeat for multiple hosts

-i, --identity-file <IDENTITY_FILE>
    SSH identity file override

-n, --dry-run
    Print the remote bootstrap changes without applying them

--install-mise <PATH>
    Install the provisioned mise on each host instead of only staging it Defaults to `~/.local/bin/mise`; pass `--install-mise=<PATH>` for another path.

--keep-staging
    Keep the remote staging directory for debugging

--mise-bin <MISE_BIN>
    Local mise binary to upload (escape hatch for custom architectures)

--no-install-mise
    Do not install mise on the host, even when the selected hosts configure it

--only <ONLY>
    Run only one or more remote bootstrap parts

--port <PORT>
    SSH port override

--prompt-secrets
    Prompt securely for missing secret inputs on the remote host

--remote-env <ENV>
    Config environments to load on the remote host; repeat or delimit with commas (for example, ci,dotfiles)

--remote-mise <COMMAND>
    Existing mise executable name or path; relative paths use the staged project

--skip <SKIP>
    Skip one or more remote bootstrap parts

--source <SOURCE>
    Local directory archived and sent to each target

--ssh-option <OPTION>
    OpenSSH `-o` option; repeat for multiple options

--tag <TAG>
    Select configured hosts with this tag; repeat to match any tag

--update
    Refresh package manager metadata and update configured repos remotely

-y, --yes
    Skip remote confirmation prompts

-h, --help
    Print help Arguments:

<TARGET>
    Inventory host names from `[bootstrap.remote.hosts]`

MISE BOOTSTRAP REPOS
Manage git repo checkouts from `[bootstrap.repos]`

Usage: mise bootstrap repos [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP REPOS APPLY
Usage: mise bootstrap repos apply [OPTIONS]

Options:

-n, --dry-run
    Print the commands that would run without running them

-y, --yes
    Skip the confirmation prompt

--skip-dirty
    Skip repos with local changes instead of failing

-h, --help
    Print help

MISE BOOTSTRAP REPOS EXEC
Usage: mise bootstrap repos exec [OPTIONS] [<PATH>] ... <COMMAND> ...

Options:

-c, --continue-on-error
    Continue running in other repos after a command fails

-n, --dry-run
    Print the commands that would run without running them

-h, --help
    Print help Arguments:

<PATH>
    Run only in matching configured or expanded paths

<COMMAND>
    Command and arguments to run in each repo

MISE BOOTSTRAP REPOS STATUS
Usage: mise bootstrap repos status [OPTIONS]

Options:

-J, --json
    Output in JSON format

--missing
    Exit with code 1 if any configured repo is not in its desired state

-h, --help
    Print help

MISE BOOTSTRAP REPOS UPDATE
Usage: mise bootstrap repos update [OPTIONS] [<PATH>] ...

Options:

-n, --dry-run
    Print the commands that would run without running them

-y, --yes
    Skip the confirmation prompt

--skip-dirty
    Skip repos with local changes instead of failing

-h, --help
    Print help Arguments:

<PATH>
    Update only matching configured or expanded paths

MISE BOOTSTRAP SECRETS
Inspect bootstrap secret inputs without revealing their values

Usage: mise bootstrap secrets [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP SECRETS STATUS
Show whether declared bootstrap secret inputs are available

Usage: mise bootstrap secrets status [OPTIONS]

Options:

-J, --json
    Output in JSON format

--missing
    Exit with code 1 if a declared secret input is unavailable

-h, --help
    Print help

MISE BOOTSTRAP SERVICES
Manage Linux system services from `[bootstrap.services]`

Usage: mise bootstrap services [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP SERVICES APPLY
Apply configured Linux system service state

Usage: mise bootstrap services apply [OPTIONS]

Options:

-n, --dry-run
    Print what would change without changing anything

-y, --yes
    Skip the confirmation prompt

-h, --help
    Print help

MISE BOOTSTRAP SERVICES STATUS
Show configured Linux system service state

Usage: mise bootstrap services status [OPTIONS]

Options:

-J, --json
    Output in JSON format

--missing
    Exit with code 1 when any service is not converged

-h, --help
    Print help

MISE BOOTSTRAP STATUS
Show the aggregate bootstrap status

Usage: mise bootstrap status [OPTIONS]

Options:

-J, --json
    Output in JSON format

--missing
    Exit with code 1 if any configured bootstrap state is not in its desired state

--prompt-secrets
    Prompt securely for missing bootstrap secret inputs

-h, --help
    Print help

MISE BOOTSTRAP USER
Manage current-user bootstrap settings from `[bootstrap.user]`

Usage: mise bootstrap user [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE BOOTSTRAP USER APPLY
Usage: mise bootstrap user apply [OPTIONS]

Options:

-n, --dry-run
    Print the commands that would run without running them

-y, --yes
    Skip the confirmation prompt

-h, --help
    Print help

MISE BOOTSTRAP USER STATUS
Usage: mise bootstrap user status [OPTIONS]

Options:

-J, --json
    Output in JSON format

--missing
    Exit with code 1 if any configured user setting is not in its desired state

-h, --help
    Print help

MISE CACHE
Manage the mise cache Run `mise cache` with no args to view the current cache directory.

Usage: mise cache [OPTIONS] [COMMAND]

Options:

-h, --help
    Print help

MISE CACHE CLEAR
Deletes all cache files in mise

Usage: mise cache clear [OPTIONS] [<TOOL>] ...

Options:

--outdate
    Mark all cache files as old

--task <TASK>
    Clear output cache entries for a task name or pattern

-h, --help
    Print help Arguments:

<TOOL>
    Tool(s) to clear cache for e.g.: node, python

MISE CACHE PATH
Show the cache directory path

Usage: mise cache path [OPTIONS]

Options:

-h, --help
    Print help

MISE CACHE PRUNE
Removes stale mise cache files By default, this command will remove files that have not been accessed in 30 days. Change this with the MISE_CACHE_PRUNE_AGE environment variable.

Usage: mise cache prune [OPTIONS] [<TOOL>] ...

Options:

-v, --verbose
    Show pruned files

--dry-run
    Just show what would be pruned

-h, --help
    Print help Arguments:

<TOOL>
    Tool(s) to prune cache for e.g.: node, python

MISE CACHE TASK
Inspect output cache entries for a task

Usage: mise cache task [OPTIONS] <TASK>

Options:

-J, --json
    Output in JSON format

-h, --help
    Print help Arguments:

<TASK>
    Task name or pattern to inspect

MISE COMPLETION
Generate shell completions

Usage: mise completion [OPTIONS] [<SHELL>]

Options:

-s, --shell <SHELL>
    Shell type to generate completions for

--include-bash-completion-lib
    Retained for compatibility with older completion generators. usage-rs's built-in bash script is self-contained, so this is now a no-op.

--usage
    Retained for compatibility with older completion generators. Completions now always use usage-rs's built-in protocol, so this is a no-op.

--install
    Install the script where this shell looks for it, instead of printing it Writes the script file and nothing else: no shell rc file and no PowerShell profile is edited. Where a shell needs a one-time line of its own — zsh's `fpath+=`, PowerShell's dot-source — it is printed for you to add.

--force
    Replace a file at the target path that mise did not write

-h, --help
    Print help Arguments:

<SHELL>
    Shell type to generate completions for

MISE CONFIG
Manage config files

Usage: mise config [OPTIONS] [COMMAND]

Options:

-J, --json
    Output in JSON format

--no-header
    Do not print table header

--tracked-configs
    List all tracked config files

-h, --help
    Print help

MISE CONFIG GET
Display the value of a setting in a mise.toml file

Usage: mise config get [OPTIONS] [<KEY>]

Options:

-f, --file, --path <FILE>
    The path to the mise.toml file to read Can be a file path or directory. If a directory is provided, the config file in that directory is used. If not provided, the nearest mise.toml file will be used

-g, --global
    Read the global config file.

--system
    Read the system config file.

-h, --help
    Print help Arguments:

<KEY>
    The path of the config to display

MISE CONFIG LS
List config files currently in use

Usage: mise config ls [OPTIONS]

Options:

-J, --json
    Output in JSON format

--no-header
    Do not print table header

--tracked-configs
    List all tracked config files

-h, --help
    Print help

MISE CONFIG SET
Set the value of a setting in a mise.toml file

Usage: mise config set [OPTIONS] <KEY> [<VALUE>]

Options:

-f, --file, --path <FILE>
    The path to the mise.toml file to edit Can be a file path or directory. If a directory is provided, the config file in that directory is used. If not provided, the nearest mise.toml file will be used

-g, --global
    Edit the global config file.

--system
    Edit the system config file.

--append
    Append the value without duplicating an existing entry.

--remove
    Remove the value from an existing collection.

-t, --type <TYPE>
    Default: infer

-h, --help
    Print help Arguments:

<KEY>
    The path of the config to display

<VALUE>
    The value to set the key to (optional if provided as KEY=VALUE)

MISE DEACTIVATE
Disable mise for current shell session This can be used to temporarily disable mise in a shell session.

Usage: mise deactivate [OPTIONS]

Options:

-h, --help
    Print help

MISE DOCTOR
Check mise installation for possible problems

Usage: mise doctor [OPTIONS] [COMMAND]

Options:

-J, --json

-h, --help
    Print help

MISE DOCTOR PATH
Print the current PATH entries mise is providing

Usage: mise doctor path [OPTIONS]

Options:

-f, --full
    Print all entries including those not provided by mise

-h, --help
    Print help

MISE EN
Starts a new shell with the mise environment built from the current configuration This is an alternative to `mise activate` that allows you to explicitly start a mise session. It will have the tools and environment variables in the configs loaded. Note that changing directories will not update the mise environment.

Usage: mise en [OPTIONS] [<DIR>]

Options:

-s, --shell <SHELL>
    Shell to start Defaults to $SHELL

-h, --help
    Print help Arguments:

<DIR>
    Directory to start the shell in
    Default: .

MISE ENV
Exports env vars to activate mise a single time Use this if you don't want to permanently install mise. It's not necessary to use this if you have `mise activate` in your shell rc file.

Usage: mise env [OPTIONS] [<TOOL@VERSION>] ...

Options:

-D, --dotenv
    Output in dotenv format

-J, --json
    Output in JSON format

-s, --shell <SHELL>
    Shell type to generate environment variables for

--json-extended
    Output in JSON format with additional information (source, tool)

--redacted
    Only show redacted environment variables

--values
    Only show values of environment variables

-h, --help
    Print help Arguments:

<TOOL@VERSION>
    Tool(s) to use

MISE EXEC
Execute a command with tool(s) set use this to avoid modifying the shell session or running ad-hoc commands with mise tools set. Tools will be loaded from mise.toml, though they can be overridden with <RUNTIME> args Note that only the plugin specified will be overridden, so if a `mise.toml` file includes "node 20" but you run `mise exec python@3.11`; it will still load node@20. The "--" separates runtimes from the commands to pass along to the subprocess.

Usage: mise exec [OPTIONS] [<TOOL@VERSION>] ... [<COMMAND>] ...

Options:

-c, --command <COMMAND>
    Command string to execute

-j, --jobs <JOBS>
    Number of jobs to run in parallel Values below 1 are treated as 1 [default: 4]
    Environment: MISE_JOBS

--allow-env <VAR>
    Allow specific env var through (implies --deny-env for everything else) Supports wildcards, e.g. --allow-env='MYAPP_*'

--allow-net <HOST>
    Allow network to specific host (implies --deny-net for everything else) macOS only in v1; on Linux falls back to allowing all network

--allow-read <PATH>
    Allow reads from specific path (implies --deny-read for everything else)

--allow-write <PATH>
    Allow writes to specific path (implies --deny-write for everything else)

--deny-all
    Block reads, writes, network, and env vars

--deny-env
    Block env var inheritance (only PATH, HOME, USER, SHELL, TERM, LANG pass through)

--deny-net
    Block all network access

--deny-read
    Block filesystem reads (system libs and tool dirs still accessible)

--deny-write
    Block all filesystem writes

--fresh-env
    Bypass the environment cache and recompute the environment

--no-deps
    Skip automatic dependency preparation

--raw
    Connect backend install command stdin/stdout/stderr directly to the terminal Implies --jobs=1

-h, --help
    Print help Arguments:

<TOOL@VERSION>
    Tool(s) to start e.g.: node@20 python@3.10

<COMMAND>
    Command string to execute (same as --command)

MISE FMT
Formats mise.toml Sorts keys and cleans up whitespace in mise.toml

Usage: mise fmt [OPTIONS]

Options:

-a, --all
    Format all files from the current directory

-c, --check
    Check if the configs are formatted, no formatting is done

-s, --stdin
    Read config from stdin and write its formatted version into stdout

-h, --help
    Print help

MISE GENERATE
Generate files for various tools/services

Usage: mise generate [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE GENERATE CONFIG
Generate a mise.toml file

Usage: mise generate config [OPTIONS] [<PATH>]

Options:

-g, --global
    Generate the global config file (~/.config/mise/config.toml)

-n, --dry-run
    Show what would be generated without writing to file

-t, --tool-versions <TOOL_VERSIONS>
    Path to a .tool-versions file to import tools from

-h, --help
    Print help Arguments:

<PATH>
    Path to the config file to create

MISE GENERATE DEVCONTAINER
Generate a devcontainer to execute mise

Usage: mise generate devcontainer [OPTIONS]

Options:

-i, --image <IMAGE>
    The image to use for the devcontainer

-m, --mount-mise-data
    Bind the mise-data-volume to the devcontainer

-n, --name <NAME>
    The name of the devcontainer

-w, --write
    write to .devcontainer/devcontainer.json

-h, --help
    Print help

MISE GENERATE GIT-PRE-COMMIT
Generate a git pre-commit hook This command generates a git pre-commit hook that runs a mise task like `mise run pre-commit` when you commit changes to your repository. Staged files are passed to the task as `STAGED`. For more advanced pre-commit functionality, see mise's sister project: https://hk.jdx.dev/

Usage: mise generate git-pre-commit [OPTIONS] [<MISE_ARG>] ...

Options:

-t, --task <TASK>
    The task to run when the pre-commit hook is triggered
    Default: pre-commit

-w, --write
    write to .git/hooks/pre-commit and make it executable

--hook <HOOK>
    Which hook to generate (saves to .git/hooks/$hook)
    Default: pre-commit

-h, --help
    Print help Arguments:

<MISE_ARG>
    mise flags to embed in the generated hook, given after `--` These are inserted between `mise` and `run`, so the hook carries the same context you would pass on the command line. Useful when the config is not at the repository root, since git runs hooks from the top level: `-- -C subdir` makes the hook find it.

MISE GENERATE GITHUB-ACTION
Generate a GitHub Action workflow file This command generates a GitHub Action workflow file that runs a mise task like `mise run ci` when you push changes to your repository.

Usage: mise generate github-action [OPTIONS]

Options:

-t, --task <TASK>
    The task to run when the workflow is triggered
    Default: ci

-w, --write
    write to .github/workflows/$name.yml

--name <NAME>
    the name of the workflow to generate
    Default: ci

-h, --help
    Print help

MISE GENERATE INSTALL-SCRIPT
Generate a script to download+execute mise This is designed to be used in a project where contributors may not have mise installed. Renamed from `mise generate bootstrap`, which read as a form of `mise bootstrap` (machine setup). The old name still works but is deprecated and will be removed in mise 2027.9.0.

Usage: mise generate install-script [OPTIONS]

Options:

-l, --localize
    Sandboxes mise internal directories like MISE_DATA_DIR and MISE_CACHE_DIR into a `.mise` directory in the project This is necessary if users may use a different version of mise outside the project.

-V, --version <VERSION>
    Specify mise version to fetch

-w, --write <WRITE>
    instead of outputting the script to stdout, write to a file and make it executable

--localized-dir <LOCALIZED_DIR>
    Directory to put localized data into
    Default: .mise

--windows
    Also write a Windows launcher, `<WRITE>.cmd` Windows cannot execute the `#!/usr/bin/env bash` script, so a contributor who clones the project on Windows has nothing to run without this. Generated on every host, not only on Windows: the file is committed, and whoever runs it on Windows is not the person who generated it. Requires `--write`, since stdout cannot carry two files.

-h, --help
    Print help

MISE GENERATE TASK-DOCS
Generate documentation for tasks in a project

Usage: mise generate task-docs [OPTIONS]

Options:

-i, --inject
    inserts the documentation into an existing file This will look for a special comment, `<!-- mise-tasks -->`, and replace it with the generated documentation. It will replace everything between the comment and the next comment, `<!-- /mise-tasks -->` so it can be run multiple times on the same file to update the documentation. The file must already contain both comments; mise errors instead of modifying the file if they are missing.

-I, --index
    write only an index of tasks, intended for use with `--multi`

-m, --multi
    render each task as a separate document, requires `--output` to be a directory

-o, --output <OUTPUT>
    writes the generated docs to a file/directory

-r, --root <ROOT>
    root directory to search for tasks

-s, --style <STYLE>
    Default: simple

-h, --help
    Print help

MISE GENERATE TASK-STUBS
Generates shims to run mise tasks By default, this will build shims like ./bin/<task>. These can be paired with `mise generate install-script` so contributors to a project can execute mise tasks without installing mise into their system. When a parent and nested task both exist, the parent stub is written to `<parent>/_default`.

Usage: mise generate task-stubs [OPTIONS]

Options:

-d, --dir <DIR>
    Directory to create task stubs inside of
    Default: bin

-m, --mise-bin <MISE_BIN>
    Path to a mise bin to use when running the task stub. Use `--mise-bin=./bin/mise` to use a mise bin generated from `mise generate install-script` On Windows a path is run as written, so that script needs its own launcher beside it: generate it with `mise generate install-script --write ./bin/mise --windows`. The default `mise` is a bare name and resolves off PATH, which needs nothing extra.
    Default: mise

--windows-launcher <WINDOWS_LAUNCHER>
    What to write beside each stub for Windows to launch `cmd` writes `<task>.cmd`. cmd.exe re-parses the whole line before `%*` expands, so an argument containing `& ^ | " %VAR%` does not reach the task intact when the launcher is called from PowerShell. `exe` writes a native `<task>.exe` instead, which receives its arguments unchanged from every shell. It is a copy of the mise-shim.exe that ships with the Windows build, so it can only be generated on Windows, and it adds ~220KB per task to a directory that is normally committed.
    Default: cmd

-h, --help
    Print help

MISE GENERATE TOOL-STUB
Generate a tool stub for HTTP-based tools This command generates tool stubs that can automatically download and execute tools from HTTP URLs. It can detect checksums, file sizes, and binary paths automatically by downloading and analyzing the tool. When generating stubs with platform-specific URLs, the command will append new platforms to existing stub files rather than overwriting them. This allows you to incrementally build cross-platform tool stubs.

Usage: mise generate tool-stub [OPTIONS] <OUTPUT>

Options:

-b, --bin <BIN>
    Binary path within the extracted archive If not specified and the archive is downloaded, will auto-detect the most likely binary

--bootstrap
    Wrap stub in a bootstrap script that installs mise if not already present When enabled, generates a bash script that: 1. Checks if mise is installed at the expected path 2. If not, downloads and installs mise using the embedded installer 3. Executes the tool stub using mise

--bootstrap-version <BOOTSTRAP_VERSION>
    Specify mise version for the bootstrap script By default, uses the latest version from the install script. Use this to pin to a specific version (e.g., "2025.1.0").

--checksum-algorithm <CHECKSUM_ALGORITHM>
    Checksum algorithm to use when downloading artifacts Accepts `blake3` or `sha256` and defaults to `blake3`. Cannot be used with `--lock` or `--skip-download` because those modes do not calculate checksums.
    Default: blake3

--fetch
    Fetch checksums and sizes for an existing tool stub file This reads an existing stub file and fills in any missing checksum/size fields by downloading the files. URLs must already be present in the stub.

--http <HTTP>
    HTTP backend type to use
    Default: http

--lock
    Resolve and embed lockfile data (exact version + platform URLs/checksums) into an existing stub file for reproducible installs without runtime API calls

--platform-bin <PLATFORM_BIN>
    Platform-specific binary paths in the format platform:path Examples: --platform-bin windows-x64:tool.exe --platform-bin linux-x64:bin/tool

--platform-url <PLATFORM_URL>
    Platform-specific URLs in the format platform:url or just url (auto-detect platform) When the output file already exists, new platforms will be appended to the existing platforms table. Existing platform URLs will be updated if specified again. If only a URL is provided (without platform:), the platform will be automatically detected from the URL filename. Examples: --platform-url linux-x64:https://... --platform-url https://nodejs.org/dist/v22.17.1/node-v22.17.1-darwin-arm64.tar.gz

--skip-download
    Skip downloading for checksum and binary path detection (faster but less informative)

-u, --url <URL>
    URL for downloading the tool Example: https://github.com/owner/repo/releases/download/v2.0.0/tool-linux-x64.tar.gz

--version <VERSION>
    Version of the tool
    Default: latest

-h, --help
    Print help Arguments:

<OUTPUT>
    Output file path for the tool stub

MISE IMPLODE
Removes mise CLI and all related data Skips config directory by default.

Usage: mise implode [OPTIONS]

Options:

-n, --dry-run
    List directories that would be removed without actually removing them

--config
    Also remove config directory

-h, --help
    Print help

MISE EDIT
Edit mise.toml interactively

Usage: mise edit [OPTIONS] [<PATH>]

Options:

-g, --global
    Edit the global config file (~/.config/mise/config.toml)

-n, --dry-run
    Show what would be generated without writing to file

-t, --tool-versions <TOOL_VERSIONS>
    Path to a .tool-versions file to import tools from

-h, --help
    Print help Arguments:

<PATH>
    Path to the config file to create

MISE INSTALL
Install a tool version Installs a tool version to `~/.local/share/mise/installs/<TOOL>/<VERSION>` Installing alone will not activate the tools so they won't be in PATH. To install and/or activate in one command, use `mise use` which will create a `mise.toml` file in the current directory to activate this tool when inside the directory. Alternatively, run `mise exec <TOOL>@<VERSION> -- <COMMAND>` to execute a tool without creating config files. Tools will be installed in parallel. To disable, set `--jobs=1` or `MISE_JOBS=1`

Usage: mise install [OPTIONS] [<TOOL@VERSION>] ...

Options:

-f, --force
    Force reinstall even if already installed With no tools specified, reinstall all configured tools

-j, --jobs <JOBS>
    Number of jobs to run in parallel Values below 1 are treated as 1 [default: 4]
    Environment: MISE_JOBS

-n, --dry-run
    Show what would be installed without actually installing

-v, --verbose
    Show installation output This argument will print backend output such as download, configuration, and compilation output.

--dry-run-code
    Like --dry-run but exits with code 1 if there are tools to install This is useful for scripts to check if tools need to be installed.

--include-task-tools
    Also install tools required by tasks in the current scope This prepares task tools without running task commands or dependencies. Combine with --monorepo to include tasks from every configured root.

--include-lazy
    Also install tools configured with `lazy = true` By default, a bare `mise install` leaves lazy tools for first-command installation.

--minimum-release-age <MINIMUM_RELEASE_AGE>
    Only install versions released before this date or older than this duration Supports absolute dates like "2024-06-01" and relative durations like "90d" or "1y".

--monorepo
    Install tools from every [monorepo].config_roots config root Uses the active MISE_ENV and requires monorepo_root = true plus explicit [monorepo].config_roots in the monorepo root config.
    Environment: MISE_MONOREPO

--raw
    Connect backend install command stdin/stdout/stderr directly to the terminal Implies --jobs=1

--shared <SHARED>
    Install tool(s) to a shared directory Installs to the specified directory instead of the default install location. May require elevated permissions depending on the path.

--system
    Install tool(s) to the system-wide shared directory Installs to /usr/local/share/mise/installs (or MISE_SYSTEM_DATA_DIR/installs). May require elevated permissions (e.g. sudo).

-h, --help
    Print help Arguments:

<TOOL@VERSION>
    Tool(s) to install e.g.: node@20

MISE INSTALL-INTO
Install a tool version to a specific path Used for building a tool to a directory for use outside of mise

Usage: mise install-into [OPTIONS] <TOOL@VERSION> <PATH>

Options:

-h, --help
    Print help Arguments:

<TOOL@VERSION>
    Tool to install e.g.: node@20

<PATH>
    Path to install the tool into

MISE LATEST
Gets the latest available version for a plugin Supports prefixes such as `node@20` to get the latest version of node 20.

Usage: mise latest [OPTIONS] <TOOL@VERSION> [<ASDF_VERSION>]

Options:

-i, --installed
    Show latest installed instead of available version

--minimum-release-age <MINIMUM_RELEASE_AGE>
    Only consider versions released before this date or older than this duration Supports absolute dates like "2024-06-01" and relative durations like "90d" or "1y". Overrides per-tool `minimum_release_age` options and the global `minimum_release_age` setting.

-h, --help
    Print help Arguments:

<TOOL@VERSION>
    Tool to get the latest version of

<ASDF_VERSION>
    The version prefix to use when querying the latest version same as the first argument after the "@" used for asdf compatibility

MISE LINK
Symlinks a tool version into mise Use this for adding installs either custom compiled outside mise or built with a different tool.

Usage: mise link [OPTIONS] <TOOL@VERSION> <PATH>

Options:

-f, --force
    Overwrite an existing tool version if it exists

-h, --help
    Print help Arguments:

<TOOL@VERSION>
    Tool name and version to create a symlink for

<PATH>
    The local path to the tool version e.g.: ~/.nvm/versions/node/v20.0.0

MISE LOCK
Update lockfile checksums and URLs for all specified platforms Updates checksums and download URLs for all platforms already specified in the lockfile. If no lockfile exists, shows what would be created based on the current configuration, including tools declared by tasks. This allows you to refresh lockfile data for platforms other than the one you're currently on. Operates on the lockfile in the current config root. Use TOOL arguments to target specific tools.

Usage: mise lock [OPTIONS] [<TOOL>] ...

Options:

-g, --global
    Target only global config lockfiles (~/.config/mise/mise.lock and system config) By default, only the active project config root is locked

-j, --jobs <JOBS>
    Number of jobs to run in parallel Values below 1 are treated as 1
    Environment: MISE_JOBS

-n, --dry-run
    Show what would be updated without making changes

-p, --platform <PLATFORM>
    Comma-separated list of platforms to target e.g.: linux-x64,macos-arm64,windows-x64 If not specified, all platforms already in lockfile will be updated

--bump
    Re-resolve fuzzy version selectors against the latest available versions By default, `mise lock` refreshes metadata for the currently locked versions. With this flag, selectors like "latest", "lts", or prefixes like "20" are re-resolved against the latest matching remote versions, so the lockfile advances without installing anything. Config files are never modified: exactly pinned versions resolve to themselves and stay unchanged (use `mise upgrade --bump` to rewrite pins in mise.toml).

--json
    Output version changes as JSON Prints an array of objects describing lockfile version changes: name, backend, lockfile, old_versions, new_versions. Version lists keep config/lockfile order; they are not sorted. Only version-level changes are reported: checksum/URL refreshes for unchanged versions produce no entries, so plain `mise lock --json` typically prints `[]` while still updating the lockfile. Suppresses the human-readable output. Combine with `--dry-run` to detect available updates without writing the lockfile.

--local
    Update mise.local.lock instead of mise.lock Use for tools defined in .local.toml configs

--minimum-release-age <MINIMUM_RELEASE_AGE>
    Only lock versions released before this age or date Supports absolute dates like "2024-06-01" and relative durations like "90d" or "1y". This only affects fuzzy version matches like "20" or "latest". Explicitly pinned versions like "22.5.0" are not filtered. Existing matching lockfile entries are preserved and are not downgraded solely by this flag.

--upgrade
    Upgrade legacy lockfiles to the latest format Existing unversioned lockfiles use format version 0 and are otherwise preserved to avoid unexpected lockfile drift. This flag upgrades them to the latest format with request-specific version bindings. Format upgrades always process every configured tool and cannot be combined with tool arguments.

-h, --help
    Print help Arguments:

<TOOL>
    Tool(s) to update in lockfile e.g.: node python If not specified, all configured and task-specific tools will be updated

MISE LS
List installed and active tool versions This command lists tools that mise "knows about". These may be tools that are currently installed, or those that are in a config file (active) but may or may not be installed. It's a useful command to get the current state of your tools.

Usage: mise ls [OPTIONS] [<INSTALLED_TOOL>] ...

Options:

-c, --current
    Only show tool versions currently specified in a mise.toml

-g, --global
    Only show tool versions currently specified in the global mise.toml

-i, --installed
    Only show tool versions that are installed (Hides tools defined in mise.toml but not installed)

-J, --json
    Output in JSON format

-l, --local
    Only show tool versions currently specified in the local mise.toml

-m, --missing
    Display missing tool versions

-o, --offline
    Don't fetch information such as outdated versions

-p, --plugin <PLUGIN>

--all-sources
    Display all tracked config sources for tools

--monorepo
    List tools from every [monorepo].config_roots config root Uses the active MISE_ENV and requires monorepo_root = true plus explicit [monorepo].config_roots in the monorepo root config.
    Environment: MISE_MONOREPO

--no-header
    Don't display headers

--outdated
    Display whether a version is outdated

--prefix <PREFIX>
    Display versions matching this prefix

--prunable
    List only tools that can be pruned with `mise prune`

-h, --help
    Print help Arguments:

<INSTALLED_TOOL>
    Only show tool versions from [TOOL]

MISE LS-REMOTE
List runtime versions available for install. Note that the results may be cached, run `mise cache clean` to clear the cache and get fresh results.

Usage: mise ls-remote [OPTIONS] [<TOOL@VERSION>] [<PREFIX>]

Options:

--all
    Show all installed plugins and versions

--minimum-release-age <MINIMUM_RELEASE_AGE>
    Only show versions released before this age or date Supports absolute dates like "2024-06-01" and relative durations like "90d" or "1y".

-J, --json
    Output in JSON format (includes version metadata like created_at timestamps when available)

--no-versions-host
    Disable checking the mise-versions host

--prerelease
    Include pre-release versions in the output for backends that report upstream prerelease metadata or opt in to regex-based prerelease detection. Equivalent to setting `MISE_PRERELEASES=1` or the `prereleases` setting for the duration of this command.

--strict-metadata
    Fail if release metadata fetches fail Requires --json and --no-versions-host. This prevents metadata consumers from accepting empty fallback results when a backend's metadata-producing upstream request fails.

-h, --help
    Print help Arguments:

<TOOL@VERSION>
    Tool to get versions for

<PREFIX>
    The version prefix to use when querying the latest version same as the first argument after the "@"

MISE MCP
Run Model Context Protocol (MCP) server This command starts an MCP server that exposes mise functionality to AI assistants over stdin/stdout using JSON-RPC protocol. The MCP server provides access to: - Installed and available tools - Task definitions and execution - Environment variables - Configuration information - Task execution via the run_task tool Resources available: - mise://tools - List all tools (use ?include_inactive=true to include inactive tools) - mise://tasks - List all tasks with their configurations - mise://env - List all environment variables - mise://config - Show configuration files and project root Tools available: - list_commands - Every mise command, with its declared effect on the world - install_tool - Install a tool with an optional version (not yet implemented) - run_task - Execute a mise task with optional arguments Note: This is primarily intended for integration with AI assistants like Claude, Cursor, or other tools that support the Model Context Protocol.

Usage: mise mcp [OPTIONS]

Options:

-h, --help
    Print help

MISE OCI
[experimental] Build OCI container images from a mise.toml Each tool becomes its own OCI layer, so bumping any single tool version only invalidates one content-addressable blob — unlike a Dockerfile where changing an early `RUN` invalidates every layer above it. This command is experimental and requires `mise settings experimental=true` (or `MISE_EXPERIMENTAL=1`). Behavior, flags, and output layout may change in future releases.

Usage: mise oci [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE OCI BUILD
[experimental] Build an OCI image from the current mise.toml Each tool version becomes its own content-addressable OCI layer. Bumping a tool version only invalidates that tool's layer — other tools, the base image, and config are reused unchanged. The output directory conforms to the OCI image-layout spec and can be consumed by `skopeo`, `crane`, or `podman load`. Requires `mise settings experimental=true` (or `MISE_EXPERIMENTAL=1`).

Usage: mise oci build [OPTIONS]

Options:

--copy <HOST_PATH:IMAGE_PATH>
    Copy a host file, directory, or symlink into the image (repeatable, HOST:IMAGE)

-o, --output <OUTPUT>
    Output directory for the OCI image layout
    Default: ./mise-oci

--from <FROM>
    Base image reference (overrides [oci].from and the oci.default_from setting)

--include-global
    Also include tools from the global / system config (default: project-only) By default `mise oci build` only packages tools declared in the project's mise config (and any parent configs at-or-below the project root, e.g. a monorepo root config). Personal dev tools in `~/.config/mise/config.toml` are excluded so they don't bake into a project image. Pass `--include-global` to revert to the old "merge all loaded configs" behavior.

-t, --tag <TAG>
    Tag to record in the image index (the org.opencontainers.image.ref.name annotation)

--mount-point <MOUNT_POINT>
    Where to place tool installs inside the image (default: /mise)

--no-mise
    Do not embed the currently-running mise binary at /usr/local/bin/mise

--owner <UID[:GID]>
    UID[:GID] to assign to every tar entry in generated layers Overrides [oci].user_id / [oci].group_id. Defaults to 0:0. If GID is omitted, it defaults to UID. This affects file ownership only; [oci].user controls the image USER directive.

-h, --help
    Print help

MISE OCI PUSH
[experimental] Build an OCI image and push it to a registry Pushes with mise's built-in registry client — no skopeo/crane/docker required. If `--image-dir` is not passed, builds fresh from the current mise.toml first. Only blobs the registry doesn't already have are uploaded, so repeat pushes of mostly-unchanged toolsets are cheap. Tool layers whose tool, version, mount point, and file owner match the previously pushed image (or `--cache-from`) are reused without being rebuilt — those tools don't even need to be installed locally. Pass `--no-cache` to force a full local rebuild. Credentials are read from the same places docker and podman use: `$REGISTRY_AUTH_FILE`, `$XDG_RUNTIME_DIR/containers/auth.json`, `~/.config/containers/auth.json`, and `~/.docker/config.json` (including credential helpers) — so `docker login` / `podman login` is all the setup needed. Requires `mise settings experimental=true` (or `MISE_EXPERIMENTAL=1`).

Usage: mise oci push [OPTIONS] <REF>

Options:

--cache-from <REF>
    Reuse unchanged tool layers from this image instead of the destination ref Must live in the same repository as the destination. Useful when each push gets a unique tag (e.g. per-commit tags in CI): `--cache-from ghcr.io/me/dev:latest ghcr.io/me/dev:$SHA`.

--from <FROM>
    Base image for the build (ignored with --image-dir)

--image-dir <IMAGE_DIR>
    Push an already-built OCI image layout (skip the build step)

--include-global
    Also include tools from the global / system config (default: project-only) See `mise oci build --help` for details.

--mount-point <MOUNT_POINT>
    Override in-image mount point (ignored with --image-dir)

--no-cache
    Don't reuse tool layers from the previously pushed image

--no-mise
    Don't embed the mise binary (ignored with --image-dir)

--owner <UID[:GID]>
    UID[:GID] to assign to every tar entry when building (conflicts with --image-dir) Overrides [oci].user_id / [oci].group_id. Defaults to 0:0. If GID is omitted, it defaults to UID. This affects file ownership only; [oci].user controls the image USER directive.

--update-index
    Maintain the tag as a multi-arch image index Pushes this build's manifest by digest and points the tag at an OCI image index containing one entry per platform, preserving entries other architectures pushed. Run `mise oci push --update-index` from one runner per platform to assemble a multi-arch tag.

-h, --help
    Print help Arguments:

<REF>
    Destination registry reference (e.g. `ghcr.io/me/devenv:latest`)

MISE OCI RUN
[experimental] Build an OCI image from the current mise.toml and run a command in it Equivalent to `mise oci build` followed by `docker run` / `podman run`. The built image is loaded into the local container engine (podman pulls the OCI layout natively; docker receives it via `docker load`) and the given command is executed inside it with stdin/stdout/stderr inherited. Requires `mise settings experimental=true` (or `MISE_EXPERIMENTAL=1`) and one of: `podman`, `docker`.

Usage: mise oci run [OPTIONS] [<CMD>] ...

Options:

--engine <ENGINE>
    Container engine to use (`auto`, `podman`, or `docker`)
    Default: auto

--from <FROM>
    Base image reference for the build (ignored with --image-dir)

--image-dir <IMAGE_DIR>
    Use an already-built OCI image layout instead of building fresh

--include-global
    Also include tools from the global / system config (default: project-only) See `mise oci build --help` for details.

--keep
    Keep the loaded image in the engine's storage after the run By default, both the container (`--rm`) and the loaded image are removed when the command exits, so repeated `mise oci run` calls don't accumulate images in podman / docker storage. Pass `--keep` to retain the image under the tag mise used (`mise-oci:run-*` for docker; the pulled image ID for podman).

--mount-point <MOUNT_POINT>
    Override in-image mount point (ignored with --image-dir)

--no-mise
    Don't embed the mise binary (ignored with --image-dir)

--owner <UID[:GID]>
    UID[:GID] to assign to every tar entry when building (conflicts with --image-dir) Overrides [oci].user_id / [oci].group_id. Defaults to 0:0. If GID is omitted, it defaults to UID. This affects file ownership only; [oci].user controls the image USER directive.

--volume <HOST:CONTAINER>
    Bind-mount a host path (repeatable, `HOST:CONTAINER[:MODE]`) Note: unlike `docker run -v`, there's no `-v` short flag here because mise reserves `-v` for --verbose. Use `--volume` or `--mount`.

-e, --env <KEY=VAL>
    Set environment variable in the container (repeatable, `KEY=VAL`)

-i, --interactive
    Run interactively (pass `-i` to the engine)

-t, --tty
    Allocate a TTY (pass `-t` to the engine)

-w, --workdir <WORKDIR>
    Working directory inside the container

-h, --help
    Print help Arguments:

<CMD>
    Command and arguments to run inside the container (after `--`)

MISE OUTDATED
Shows outdated tool versions See `mise upgrade` to upgrade these versions.

Usage: mise outdated [OPTIONS] [<TOOL@VERSION>] ...

Options:

-b, --bump
    Compares against the latest versions available, not what matches the current config For example, if you have `node = "20"` in your config by default `mise outdated` will only show other 20.x versions, not 21.x or 22.x versions. Using this flag, if there are 21.x or newer versions it will display those instead of 20.x.

-J, --json
    Output in JSON format

-l  Deprecated shorthand for --bump

--inactive
    Show outdated tools including installed-but-inactive tools not present in the current config By default, `mise outdated` only shows tools that come from the current config.

--local
    Only show outdated tools defined in local config files This will only show tools that are defined in project-local mise.toml and will skip tools defined in the global config (~/.config/mise/config.toml).

--monorepo
    Placeholder for future monorepo outdated checks; `mise outdated --monorepo` is not implemented yet.

--no-header
    Don't show table header

-h, --help
    Print help Arguments:

<TOOL@VERSION>
    Tool(s) to show outdated versions for e.g.: node@20 python@3.10 If not specified, all tools in global and local configs will be shown

MISE PATRONS
Show the individuals supporting mise as Patron-tier members Lists the individuals on the Patron tier from <https://jdx.dev/patrons.json>. The list refreshes daily; supporting terminals will render each patron's name as a clickable link via OSC 8 hyperlinks. To appear here, become a patron at <https://jdx.dev/sponsors.html>.

Usage: mise patrons [OPTIONS]

Options:

-J, --json
    Output in JSON format

--refresh
    Bypass the local cache and re-fetch

-h, --help
    Print help

MISE PLUGINS
Manage plugins

Usage: mise plugins [OPTIONS] [COMMAND]

Options:

-a, --all
    list all available remote plugins same as `mise plugins ls-remote`

-c, --core
    The built-in plugins only Normally these are not shown

-u, --urls
    Show the git url for each plugin e.g.: https://github.com/mise-plugins/vfox-cmake.git

--refs
    Show the git refs for each plugin e.g.: main 1234abc

--user
    List installed plugins This is the default behavior but can be used with --core to show core and user plugins

-h, --help
    Print help

MISE PLUGINS INSTALL
Install a plugin note that mise can automatically install plugins when you install a tool e.g.: `mise install cmake@3.30` will autoinstall the cmake plugin This behavior can be modified in ~/.config/mise/config.toml

Usage: mise plugins install [OPTIONS] [<NEW_PLUGIN>] [<GIT_URL>] [<REST>] ...

Options:

-a, --all
    Install all missing plugins This will only install plugins that have matching shorthands. i.e.: they don't need the full git repo url

-f, --force
    Reinstall even if plugin exists

-j, --jobs <JOBS>
    Number of jobs to run in parallel Values below 1 are treated as 1

-v, --verbose
    Show installation output

-h, --help
    Print help Arguments:

<NEW_PLUGIN>
    The name of the plugin to install e.g.: cmake, poetry Can specify multiple plugins: `mise plugins install cmake poetry`

<GIT_URL>
    The git url of the plugin

MISE PLUGINS LINK
Symlinks a plugin into mise This is used for developing a plugin.

Usage: mise plugins link [OPTIONS] <NAME> [<DIR>]

Options:

-f, --force
    Overwrite existing plugin

-h, --help
    Print help Arguments:

<NAME>
    The name of the plugin e.g.: cmake, poetry

<DIR>
    The local path to the plugin e.g.: ./vfox-cmake

MISE PLUGINS LS
List installed plugins Can also show remotely available plugins to install.

Usage: mise plugins ls [OPTIONS]

Options:

-a, --all
    List all available remote plugins Same as `mise plugins ls-remote`

-c, --core
    The built-in plugins only Normally these are not shown

-o, --outdated
    Show plugins with available updates Checks the remote for newer versions and only displays plugins that are outdated

-u, --urls
    Show the git url for each plugin e.g.: https://github.com/mise-plugins/vfox-cmake.git

--refs
    Show the git refs for each plugin e.g.: main 1234abc

--user
    List installed plugins

-h, --help
    Print help

MISE PLUGINS LS-REMOTE
List all available remote plugins The full list is here: https://github.com/jdx/mise/blob/main/registry/ Examples:
    $ mise plugins ls-remote

Usage: mise plugins ls-remote [OPTIONS]

Options:

-u, --urls
    Show the git url for each plugin e.g.: https://github.com/mise-plugins/mise-poetry.git

--only-names
    Only show the name of each plugin by default it will show a "*" next to installed plugins

-h, --help
    Print help

MISE PLUGINS UNINSTALL
Removes a plugin

Usage: mise plugins uninstall [OPTIONS] [<PLUGIN>] ...

Options:

-a, --all
    Remove all plugins

-p, --purge
    Also remove the plugin's installs, downloads, and cache

-h, --help
    Print help Arguments:

<PLUGIN>
    Plugin(s) to remove

MISE PLUGINS UPDATE
Updates a plugin to the latest version note: this updates the plugin itself, not the runtime versions

Usage: mise plugins update [OPTIONS] [<PLUGIN>] ...

Options:

-j, --jobs <JOBS>
    Number of jobs to run in parallel Values below 1 are treated as 1 Default: 4

-h, --help
    Print help Arguments:

<PLUGIN>
    Plugin(s) to update

MISE DEPS
[experimental] Manage project dependencies Runs all applicable dependency install steps for the current project. This checks if dependency lockfiles are newer than installed outputs (e.g., package-lock.json vs node_modules/) and runs install commands if needed. Providers with `auto = true` are automatically invoked before `mise x` and `mise run` unless skipped with the --no-deps flag.

Usage: mise deps [OPTIONS] [<PROVIDER>] [COMMAND]

Options:

--explain
    Show why a provider is fresh or stale (requires a provider argument)

-f, --force
    Force run all deps steps even if outputs are fresh

-n, --dry-run
    Only check if deps install is needed, don't run commands

--list
    Show what deps providers are available

--monorepo
    Install dependencies from every [monorepo].config_roots config root Requires monorepo_root = true plus explicit [monorepo].config_roots in the monorepo root config. Providers are named like //apps/api:uv.
    Environment: MISE_MONOREPO

--only <ONLY>
    Run specific deps rule(s) only

--skip <SKIP>
    Skip specific deps rule(s)

-h, --help
    Print help Arguments:

<PROVIDER>
    Provider to operate on (runs only this provider, or use with --explain)

MISE DEPS ADD
Add a dependency Adds one or more packages to the project using the appropriate package manager. Package specs use the format `ecosystem:package`, e.g., `npm:react` or `npm:@types/react@19`.

Usage: mise deps add [OPTIONS] <PACKAGES> ...

Options:

-D, --dev
    Add as a development dependency

-h, --help
    Print help Arguments:

<PACKAGES>
    Package(s) to add (e.g., npm:react, npm:@types/react@19)

MISE DEPS INSTALL
Install all project dependencies Checks if dependency lockfiles are newer than installed outputs and runs install commands if needed.

Usage: mise deps install [OPTIONS] [<PROVIDER>]

Options:

--explain
    Show why a provider is fresh or stale (requires a provider argument)

-f, --force
    Force run all deps steps even if outputs are fresh

-n, --dry-run
    Only check if deps install is needed, don't run commands

--list
    Show what deps providers are available

--monorepo
    Install dependencies from every [monorepo].config_roots config root Requires monorepo_root = true plus explicit [monorepo].config_roots in the monorepo root config. Providers are named like //apps/api:uv.
    Environment: MISE_MONOREPO

--only <ONLY>
    Run specific deps rule(s) only

--skip <SKIP>
    Skip specific deps rule(s)

-h, --help
    Print help Arguments:

<PROVIDER>
    Provider to operate on (runs only this provider, or use with --explain)

MISE DEPS REMOVE
Remove a dependency Removes one or more packages from the project using the appropriate package manager. Package specs use the format `ecosystem:package`, e.g., `npm:lodash`.

Usage: mise deps remove [OPTIONS] <PACKAGES> ...

Options:

-h, --help
    Print help Arguments:

<PACKAGES>
    Package(s) to remove (e.g., npm:lodash)

MISE PRUNE
Delete unused versions of tools mise tracks which config files have been used in ~/.local/state/mise/tracked-configs Versions which are no longer the latest specified in any of those configs are deleted. Versions installed only with environment variables `MISE_<TOOL>_VERSION` will be deleted, as will versions only referenced on the command line `mise exec <TOOL>@<VERSION>`. Tool stubs that have been executed are tracked in ~/.local/state/mise/tracked-stubs. Versions still referenced by a tracked stub are not deleted. You can list prunable tools with `mise ls --prunable`

Usage: mise prune [OPTIONS] [<INSTALLED_TOOL>] ...

Options:

-n, --dry-run
    Do not actually delete anything

--configs
    Prune only tracked and trusted configuration links that point to nonexistent configurations

--dry-run-code
    Like --dry-run but exits with code 1 if there are tools to prune This is useful for scripts to check if tools need to be pruned.

--monorepo
    Placeholder for future monorepo pruning; `mise prune --monorepo` is not implemented yet.

--tools
    Prune only unused versions of tools

-h, --help
    Print help Arguments:

<INSTALLED_TOOL>
    Prune only these tools

MISE REGISTRY
List available tools to install This command lists the tools available in the registry as shorthand names. For example, `poetry` is shorthand for `asdf:mise-plugins/mise-poetry`.

Usage: mise registry [OPTIONS] [<NAME>]

Options:

-b, --backend <BACKEND>
    Show only tools for this backend

--complete
    Print all tools with descriptions for shell completions

--hide-aliased
    Hide aliased tools

-J, --json
    Output in JSON format

--security
    Include security features for each tool's backends in JSON output. Requires --json. Security info is de-duplicated across all of a tool's backends. This can add noticeable time for large listings since each backend's security info is resolved individually.

-h, --help
    Print help Arguments:

<NAME>
    Show only the specified tool's full name

MISE RESHIM
Creates new shims based on bin paths from currently installed tools. This creates new shims in the configured user shim directory for CLIs that have been added. With `--system`, it rebuilds the configured system shim farm instead. mise will try to do this automatically for commands like `npm i -g` but there are other ways to install things (like using yarn or pnpm for node) that mise does not know about and so it will be necessary to call this explicitly. If you think mise should automatically call this for a particular command, please open an issue on the mise repo. You can also set up a shell function to reshim automatically (it's really fast so you don't need to worry about overhead):
    npm() {
      command npm "$@"
      mise reshim
    } Note that this creates shims for _all_ installed tools, not just the ones that are currently active in mise.toml.

Usage: mise reshim [OPTIONS] [<TOOL>] [<VERSION>]

Options:

-f, --force
    Rebuilds all mise-owned shims

--system
    Rebuild the system shim farm

-h, --help
    Print help

MISE RUN
Run task(s) This command will run a task, or multiple tasks in parallel. Tasks may have dependencies on other tasks or on source files. If source is configured on a task, it will only run if the source files have changed. Tasks can be defined in mise.toml or as standalone scripts. In mise.toml, tasks take this form:
    [tasks.build]
    run = "npm run build"
    sources = ["src/**/*.ts"]
    outputs = ["dist/**/*.js"] Alternatively, tasks can be defined as standalone scripts. These must be located in `mise-tasks`, `.mise-tasks`, `.mise/tasks`, `mise/tasks` or `.config/mise/tasks`. The name of the script will be the name of the tasks.
    $ cat .mise/tasks/build<<EOF
    #!/usr/bin/env bash
    npm run build
    EOF
    $ mise run build

Usage: mise run [OPTIONS]

Options:

--affected
    Run matching tasks only for projects affected by Git changes

--affected-base <REV>
    Git base revision for --affected Defaults to MISE_AFFECTED_BASE, CI metadata, or HEAD~1

--affected-explain
    Explain why projects and tasks were selected by --affected

--affected-head <REV>
    Git head revision for --affected Defaults to MISE_AFFECTED_HEAD, CI metadata, or HEAD

--affected-json
    Output affected projects and tasks as JSON without running tasks

--all
    Open the interactive selector with all tasks from the entire monorepo

-c, --continue-on-error
    Continue running tasks even if one fails

-C, --cd <CD>
    Change to this directory before executing the command

-f, --force
    Force the tasks to run even if outputs are up to date

-j, --jobs <JOBS>
    Number of tasks to run in parallel Values below 1 are treated as 1 [default: 4] Configure with `jobs` config or `MISE_JOBS` env var
    Environment: MISE_JOBS

-n, --dry-run
    Don't actually run the task(s), just print them in order of execution

-o, --output <OUTPUT>
    Change how tasks information is output when running tasks - `prefix` - Print stdout/stderr by line, prefixed with the task's label - `interleave` - Print directly to stdout/stderr instead of by line - `replacing` - Stdout is replaced each time, stderr is printed as is - `timed` - Only show stdout lines if they are displayed for more than 1 second - `keep-order` - Print stdout/stderr by line, prefixed with the task's label, but keep the order of the output - `quiet` - Don't show extra output - `silent` - Don't show any output including stdout and stderr from the task except for errors
    Environment: MISE_TASK_OUTPUT

-q, --quiet
    Don't show extra output
    Environment: MISE_QUIET

-r, --raw
    Read/write directly to stdin/stdout/stderr instead of by line Redactions are not applied with this option Configure with `raw` config or `MISE_RAW` env var

-s, --shell <SHELL>
    Shell to use to run toml tasks Defaults to `sh -c -o errexit -o pipefail` on unix, and `cmd /c` on Windows Can also be set with the setting `MISE_UNIX_DEFAULT_INLINE_SHELL_ARGS` or `MISE_WINDOWS_DEFAULT_INLINE_SHELL_ARGS` Or it can be overridden with the `shell` property on a task.

-S, --silent
    Don't show any output except for errors
    Environment: MISE_SILENT

-t, --tool <TOOL@VERSION>
    Tool(s) to run in addition to what is in mise.toml files e.g.: node@20 python@3.10

--allow-env <VAR>
    Allow specific env var through (implies --deny-env for everything else) Supports wildcards, e.g. --allow-env='MYAPP_*'

--allow-net <HOST>
    Allow network to specific host (implies --deny-net for everything else)

--allow-read <PATH>
    Allow reads from specific path (implies --deny-read for everything else)

--allow-write <PATH>
    Allow writes to specific path (implies --deny-write for everything else)

--deny-all
    Block reads, writes, network, and env vars

--deny-env
    Block env var inheritance (only PATH, HOME, USER, SHELL, TERM, LANG pass through)

--deny-net
    Block all network access

--deny-read
    Block filesystem reads (system libs and tool dirs still accessible)

--deny-write
    Block all filesystem writes

--fresh-env
    Bypass the environment cache and recompute the environment

--no-cache
    Do not use cache on remote tasks
    Environment: MISE_TASK_REMOTE_NO_CACHE

--no-deps
    Skip automatic dependency preparation

--no-timings
    Hides elapsed time after each task completes Default to always hide with `MISE_TASK_TIMINGS=0`

--skip-deps
    Run only the specified tasks skipping all dependencies
    Environment: MISE_TASK_SKIP_DEPENDS

--skip-tools
    Skip installing tools before running tasks Can also be set persistently with the `task.run_auto_install` setting or `MISE_TASK_RUN_AUTO_INSTALL=false` env var

--task-cache <TASK_CACHE>
    Set task output cache access for this run - `read-write` - Read cached results and write new results - `read-only` - Read cached results without writing new results - `write-only` - Write new results without reading cached results - `off` - Disable task output caching - `local-only` - Read and write only the local cache; currently equivalent to `read-write`
    Default: read-write
    Environment: MISE_TASK_CACHE

--task-cache-explain
    Explain the inputs that produced each task's output cache key

--task-cache-explain-json
    Output cache-key input details as JSON Lines without running tasks

--task-cache-stats
    Report task output cache hits, restored bytes, and time saved

--timeout <TIMEOUT>
    Timeout for the task to complete e.g.: 30s, 5m

--timings
    Shows elapsed time after each task completes Default to always show with `MISE_TASK_TIMINGS=1`

MISE SEARCH
Search for tools in the registry This command searches a tool in the registry. By default, it will show all tools that fuzzy match the search term. For non-fuzzy matches, use the `--match-type` flag.

Usage: mise search [OPTIONS] [<NAME>]

Options:

-i, --interactive
    Show interactive search

-m, --match-type <MATCH_TYPE>
    Match type: equal, contains, or fuzzy
    Default: fuzzy

--no-header
    Don't display headers

-h, --help
    Print help Arguments:

<NAME>
    The tool to search for

MISE SELF-UPDATE
Updates mise itself. Uses the GitHub Releases API to find the latest release and binary. By default, this will also update any installed plugins. Uses mise's GitHub token resolution chain for authenticated requests. Packagers can disable this command so that mise is updated through the package manager instead. See https://mise.jdx.dev/contributing.html#packaging-and-self-update-instructions

Usage: mise self-update [OPTIONS] [<VERSION>]

Options:

-f, --force
    Update even if already up to date

-y, --yes
    Skip confirmation prompt

--no-plugins
    Disable auto-updating plugins

-h, --help
    Print help Arguments:

<VERSION>
    Update to a specific version

MISE SET
Set environment variables in mise.toml By default, this command modifies `mise.toml` in the current directory. If multiple config files exist (e.g., both `mise.toml` and `mise.local.toml`), the lowest precedence file (`mise.toml`) will be used. See https://mise.jdx.dev/configuration.html#target-file-for-write-operations Use `-E <env>` to create/modify environment-specific config files like `mise.<env>.toml`.

Usage: mise set [OPTIONS] [<ENV_VAR>] ...

Options:

-E, --env <ENV>
    Create/modify an environment-specific config file like .mise.<env>.toml

-g, --global
    Set the environment variable in the global config file

--age-encrypt
    [experimental] Encrypt the value with age before storing

--age-key-file <PATH>
    [experimental] Age identity file for encryption Defaults to ~/.config/mise/age.txt if it exists

--age-recipient <RECIPIENT>
    [experimental] Age recipient (x25519 public key) for encryption Can be used multiple times. Requires --age-encrypt.

--age-ssh-recipient <PATH_OR_PUBKEY>
    [experimental] SSH recipient (public key or path) for age encryption Can be used multiple times. Requires --age-encrypt.

--complete
    Render completions

--file, --path <FILE>
    The TOML file to update Can be a file path or directory. If a directory is provided, will create/use mise.toml in that directory. Defaults to [`MISE_DEFAULT_CONFIG_FILENAME`](https://mise.jdx.dev/configuration.html#mise_default_config_filename) environment variable, or `mise.toml`. Use [`MISE_GLOBAL_CONFIG_FILE`](https://mise.jdx.dev/configuration.html#mise_global_config_file) to choose a different global config path.

--no-redact
    Show raw values instead of redacting secrets

--prompt
    Prompt for environment variable values

--remove, --rm, --unset <ENV_KEY>
    Remove the environment variable from config file Can be used multiple times.

--stdin
    Read the value from stdin (for multiline input) When using --stdin, provide a single key without a value. The value will be read from stdin until EOF.

-h, --help
    Print help Arguments:

<ENV_VAR>
    Environment variable(s) to set e.g.: NODE_ENV=production

MISE SETTINGS
Manage settings

Usage: mise settings [OPTIONS] [<SETTING>] [<VALUE>] [COMMAND]

Options:

-a, --all
    List all settings

-J, --json
    Output in JSON format

-l, --local
    Use the local config file instead of the global one

-T, --toml
    Output in TOML format

--complete
    Print all settings with descriptions for shell completions

--json-extended
    Output in JSON format with sources

-h, --help
    Print help Arguments:

<SETTING>
    Name of setting

<VALUE>
    Setting value to set

MISE SETTINGS ADD
Adds a setting to the configuration file Used with an array setting, this will append the value to the array. This modifies the contents of ~/.config/mise/config.toml

Usage: mise settings add [OPTIONS] <SETTING> [<VALUE>]

Options:

-l, --local
    Use the local config file instead of the global one

-h, --help
    Print help Arguments:

<SETTING>
    The setting to set

<VALUE>
    The value to set (optional if provided as KEY=VALUE)

MISE SETTINGS GET
Show a current setting This is the contents of a single entry in ~/.config/mise/config.toml Note that aliases are also stored in this file but managed separately with `mise tool-alias get`

Usage: mise settings get [OPTIONS] <SETTING>

Options:

-l, --local
    Use the local config file instead of the global one

-h, --help
    Print help Arguments:

<SETTING>
    The setting to show

MISE SETTINGS LS
Show current settings This is the contents of ~/.config/mise/config.toml Note that aliases are also stored in this file but managed separately with `mise tool-alias`

Usage: mise settings ls [OPTIONS] [<SETTING>]

Options:

-a, --all
    List all settings

-J, --json
    Output in JSON format

-l, --local
    Use the local config file instead of the global one

-T, --toml
    Output in TOML format

--complete
    Print all settings with descriptions for shell completions

--json-extended
    Output in JSON format with sources

-h, --help
    Print help Arguments:

<SETTING>
    Name of setting

MISE SETTINGS SET
Add/update a setting This modifies the contents of ~/.config/mise/config.toml by default. With `--local`, modifies the local config file instead. See https://mise.jdx.dev/configuration.html#target-file-for-write-operations

Usage: mise settings set [OPTIONS] <SETTING> [<VALUE>]

Options:

-l, --local
    Use the local config file instead of the global one

-h, --help
    Print help Arguments:

<SETTING>
    The setting to set

<VALUE>
    The value to set (optional if provided as KEY=VALUE)

MISE SETTINGS UNSET
Clears a setting This modifies the contents of ~/.config/mise/config.toml

Usage: mise settings unset [OPTIONS] <KEY>

Options:

-l, --local
    Use the local config file instead of the global one

-h, --help
    Print help Arguments:

<KEY>
    The setting to remove

MISE SHELL
Sets a tool version for the current session. Only works in a session where mise is already activated. This works by setting environment variables for the current shell session such as `MISE_NODE_VERSION=20` which is "eval"ed as a shell function created by `mise activate`.

Usage: mise shell [OPTIONS] <TOOL@VERSION> ...

Options:

-j, --jobs <JOBS>
    Number of jobs to run in parallel Values below 1 are treated as 1 [default: 4]
    Environment: MISE_JOBS

-u, --unset
    Removes a previously set version

--raw
    Connect backend install command stdin/stdout/stderr directly to the terminal Implies --jobs=1

-h, --help
    Print help Arguments:

<TOOL@VERSION>
    Tool(s) to use

MISE SHELL-ALIAS
Manage shell aliases.

Usage: mise shell-alias [OPTIONS] [COMMAND]

Options:

--no-header
    Don't show table header

-h, --help
    Print help

MISE SHELL-ALIAS GET
Show the command for a shell alias

Usage: mise shell-alias get [OPTIONS] <shell_alias>

Options:

-h, --help
    Print help Arguments:

<shell_alias>
    The alias to show

MISE SHELL-ALIAS LS
List shell aliases Shows the shell aliases that are set in the current directory. These are defined in `mise.toml` under the `[shell_alias]` section.

Usage: mise shell-alias ls [OPTIONS]

Options:

--no-header
    Don't show table header

-h, --help
    Print help

MISE SHELL-ALIAS SET
Add/update a shell alias This modifies the contents of ~/.config/mise/config.toml

Usage: mise shell-alias set [OPTIONS] <shell_alias> [<COMMAND>]

Options:

-h, --help
    Print help Arguments:

<shell_alias>
    The alias name

<COMMAND>
    The command to run (optional if provided as ALIAS=COMMAND)

MISE SHELL-ALIAS UNSET
Removes a shell alias This modifies the contents of ~/.config/mise/config.toml

Usage: mise shell-alias unset [OPTIONS] <shell_alias>

Options:

-h, --help
    Print help Arguments:

<shell_alias>
    The alias to remove

MISE SPONSORS
Show the companies sponsoring mise and the jdx.dev open source tools

Usage: mise sponsors [OPTIONS]

Options:

-h, --help
    Print help

MISE SYNC
Synchronize tools from other version managers with mise

Usage: mise sync [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE SYNC NODE
Symlinks all tool versions from an external tool into mise For example, use this to import all Homebrew node installs into mise This won't overwrite managed installs, runtime aliases, or links from other providers.

Usage: mise sync node [OPTIONS]

Options:

--brew
    Get tool versions from Homebrew

--nodenv
    Get tool versions from nodenv

--nvm
    Get tool versions from nvm

-h, --help
    Print help

MISE SYNC PYTHON
Symlinks all tool versions from an external tool into mise For example, use this to import all pyenv installs into mise This won't overwrite managed installs, runtime aliases, or links from other providers.

Usage: mise sync python [OPTIONS]

Options:

--pyenv
    Get tool versions from pyenv

--uv
    Sync tool versions with uv (2-way sync)

-h, --help
    Print help

MISE SYNC RUBY
Symlinks all ruby tool versions from an external tool into mise

Usage: mise sync ruby [OPTIONS]

Options:

--brew
    Get tool versions from Homebrew

-h, --help
    Print help

MISE TASKS
Manage tasks

Usage: mise tasks [OPTIONS] [<TASK>] [COMMAND]

Options:

-g, --global
    Only show global tasks

-J, --json
    Output in JSON format

-l, --local
    Only show non-global tasks

-x, --extended
    Show all columns

--all
    Load all tasks from the entire monorepo, including sibling directories. By default, only tasks from the current directory hierarchy are loaded.

--complete
    Display tasks for usage completion

--hidden
    Show hidden tasks

--name-only
    Only show task names, one per line. Useful for piping to fzf and similar tools.

--no-header
    Do not print table header

--sort <COLUMN>
    Sort by column. Default is name.

--sort-order <SORT_ORDER>
    Sort order. Default is asc.

--usage

-h, --help
    Print help Arguments:

<TASK>
    Task name to get info of

MISE TASKS ADD
Create a new task Adds a task to the local mise.toml file. See https://mise.jdx.dev/configuration.html#target-file-for-write-operations

Usage: mise tasks add [OPTIONS] <TASK> [<RUN>] ...

Options:

-a, --alias <ALIAS>
    Other names for the task

-d, --depends <DEPENDS>
    Add dependencies to the task

-D, --dir <DIR>
    Run the task in a specific directory

-f, --file
    Create a file task instead of a toml task

-H, --hide
    Hide the task from `mise tasks` and completions

-q, --quiet
    Do not print the command before running

-r, --raw
    Directly connect stdin/stdout/stderr

-s, --sources <SOURCES>
    Glob patterns of files this task uses as input

-w, --wait-for <WAIT_FOR>
    Wait for these tasks to complete if they are to run

--depends-post <DEPENDS_POST>
    Dependencies to run after the task runs

--description <DESCRIPTION>
    Description of the task

--outputs <OUTPUTS>
    Glob patterns of files this task creates, to skip if they are not modified

--run-windows <RUN_WINDOWS>
    Command to run on windows

--shell <SHELL>
    Run the task in a specific shell

--silent
    Do not print the command or its output

-h, --help
    Print help Arguments:

<TASK>
    Tasks name to add

MISE TASKS DEPS
Display a tree visualization of a dependency graph The graph is built from declared dependencies: `depends`, `depends_post`, and `wait_for`. Task references inside a `run` or `run_windows` array (`{ task = "..." }` or `{ tasks = [...] }`) are execution steps, not graph edges, so they do not appear here. Those nested tasks still run, including their own `depends`.

Usage: mise tasks deps [OPTIONS] [<TASKS>] ...

Options:

--compact
    Collapse repeated dependencies after their first occurrence

--dot
    Display dependencies in DOT format

--hidden
    Show hidden tasks

-h, --help
    Print help Arguments:

<TASKS>
    Tasks to show dependencies for Can specify multiple tasks by separating with spaces e.g.: mise tasks deps lint test check

MISE TASKS EDIT
Edit a task with $EDITOR The task will be created as a standalone script if it does not already exist.

Usage: mise tasks edit [OPTIONS] <TASK>

Options:

-p, --path
    Display the path to the task instead of editing it

-h, --help
    Print help Arguments:

<TASK>
    Task to edit

MISE TASKS GRAPH
[experimental] Inspect the workspace project graph

Usage: mise tasks graph [OPTIONS]

Options:

-J, --json
    Output the project graph as JSON

--explain
    Explain provider attribution for inferred projects and tasks

--no-header
    Do not print table headers

-h, --help
    Print help

MISE TASKS INFO
Get information about a task

Usage: mise tasks info [OPTIONS] <TASK>

Options:

-J, --json
    Output in JSON format

-h, --help
    Print help Arguments:

<TASK>
    Name of the task to get information about

MISE TASKS LS
List available tasks to execute These may be included from the config file or from the project's .mise/tasks directory mise will merge all tasks from all parent directories into this list. So if you have global tasks in `~/.config/mise/tasks/*` and project-specific tasks in ~/myproject/.mise/tasks/*, then they'll both be available but the project-specific tasks will override the global ones if they have the same name.

Usage: mise tasks ls [OPTIONS]

Options:

-g, --global
    Only show global tasks

-J, --json
    Output in JSON format

-l, --local
    Only show non-global tasks

-x, --extended
    Show all columns

--all
    Load all tasks from the entire monorepo, including sibling directories. By default, only tasks from the current directory hierarchy are loaded.

--complete
    Display tasks for usage completion

--hidden
    Show hidden tasks

--name-only
    Only show task names, one per line. Useful for piping to fzf and similar tools.

--no-header
    Do not print table header

--sort <COLUMN>
    Sort by column. Default is name.

--sort-order <SORT_ORDER>
    Sort order. Default is asc.

--usage

-h, --help
    Print help

MISE TASKS RUN
Run task(s) This command will run a task, or multiple tasks in parallel. Tasks may have dependencies on other tasks or on source files. If source is configured on a task, it will only run if the source files have changed. Tasks can be defined in mise.toml or as standalone scripts. In mise.toml, tasks take this form:
    [tasks.build]
    run = "npm run build"
    sources = ["src/**/*.ts"]
    outputs = ["dist/**/*.js"] Alternatively, tasks can be defined as standalone scripts. These must be located in `mise-tasks`, `.mise-tasks`, `.mise/tasks`, `mise/tasks` or `.config/mise/tasks`. The name of the script will be the name of the tasks.
    $ cat .mise/tasks/build<<EOF
    #!/usr/bin/env bash
    npm run build
    EOF
    $ mise run build

Usage: mise tasks run [OPTIONS]

Options:

--affected
    Run matching tasks only for projects affected by Git changes

--affected-base <REV>
    Git base revision for --affected Defaults to MISE_AFFECTED_BASE, CI metadata, or HEAD~1

--affected-explain
    Explain why projects and tasks were selected by --affected

--affected-head <REV>
    Git head revision for --affected Defaults to MISE_AFFECTED_HEAD, CI metadata, or HEAD

--affected-json
    Output affected projects and tasks as JSON without running tasks

--all
    Open the interactive selector with all tasks from the entire monorepo

-c, --continue-on-error
    Continue running tasks even if one fails

-C, --cd <CD>
    Change to this directory before executing the command

-f, --force
    Force the tasks to run even if outputs are up to date

-j, --jobs <JOBS>
    Number of tasks to run in parallel Values below 1 are treated as 1 [default: 4] Configure with `jobs` config or `MISE_JOBS` env var
    Environment: MISE_JOBS

-n, --dry-run
    Don't actually run the task(s), just print them in order of execution

-o, --output <OUTPUT>
    Change how tasks information is output when running tasks - `prefix` - Print stdout/stderr by line, prefixed with the task's label - `interleave` - Print directly to stdout/stderr instead of by line - `replacing` - Stdout is replaced each time, stderr is printed as is - `timed` - Only show stdout lines if they are displayed for more than 1 second - `keep-order` - Print stdout/stderr by line, prefixed with the task's label, but keep the order of the output - `quiet` - Don't show extra output - `silent` - Don't show any output including stdout and stderr from the task except for errors
    Environment: MISE_TASK_OUTPUT

-q, --quiet
    Don't show extra output
    Environment: MISE_QUIET

-r, --raw
    Read/write directly to stdin/stdout/stderr instead of by line Redactions are not applied with this option Configure with `raw` config or `MISE_RAW` env var

-s, --shell <SHELL>
    Shell to use to run toml tasks Defaults to `sh -c -o errexit -o pipefail` on unix, and `cmd /c` on Windows Can also be set with the setting `MISE_UNIX_DEFAULT_INLINE_SHELL_ARGS` or `MISE_WINDOWS_DEFAULT_INLINE_SHELL_ARGS` Or it can be overridden with the `shell` property on a task.

-S, --silent
    Don't show any output except for errors
    Environment: MISE_SILENT

-t, --tool <TOOL@VERSION>
    Tool(s) to run in addition to what is in mise.toml files e.g.: node@20 python@3.10

--allow-env <VAR>
    Allow specific env var through (implies --deny-env for everything else) Supports wildcards, e.g. --allow-env='MYAPP_*'

--allow-net <HOST>
    Allow network to specific host (implies --deny-net for everything else)

--allow-read <PATH>
    Allow reads from specific path (implies --deny-read for everything else)

--allow-write <PATH>
    Allow writes to specific path (implies --deny-write for everything else)

--deny-all
    Block reads, writes, network, and env vars

--deny-env
    Block env var inheritance (only PATH, HOME, USER, SHELL, TERM, LANG pass through)

--deny-net
    Block all network access

--deny-read
    Block filesystem reads (system libs and tool dirs still accessible)

--deny-write
    Block all filesystem writes

--fresh-env
    Bypass the environment cache and recompute the environment

--no-cache
    Do not use cache on remote tasks
    Environment: MISE_TASK_REMOTE_NO_CACHE

--no-deps
    Skip automatic dependency preparation

--no-timings
    Hides elapsed time after each task completes Default to always hide with `MISE_TASK_TIMINGS=0`

--skip-deps
    Run only the specified tasks skipping all dependencies
    Environment: MISE_TASK_SKIP_DEPENDS

--skip-tools
    Skip installing tools before running tasks Can also be set persistently with the `task.run_auto_install` setting or `MISE_TASK_RUN_AUTO_INSTALL=false` env var

--task-cache <TASK_CACHE>
    Set task output cache access for this run - `read-write` - Read cached results and write new results - `read-only` - Read cached results without writing new results - `write-only` - Write new results without reading cached results - `off` - Disable task output caching - `local-only` - Read and write only the local cache; currently equivalent to `read-write`
    Default: read-write
    Environment: MISE_TASK_CACHE

--task-cache-explain
    Explain the inputs that produced each task's output cache key

--task-cache-explain-json
    Output cache-key input details as JSON Lines without running tasks

--task-cache-stats
    Report task output cache hits, restored bytes, and time saved

--timeout <TIMEOUT>
    Timeout for the task to complete e.g.: 30s, 5m

--timings
    Shows elapsed time after each task completes Default to always show with `MISE_TASK_TIMINGS=1`

MISE TASKS VALIDATE
Validate tasks for common errors and issues

Usage: mise tasks validate [OPTIONS] [<TASKS>] ...

Options:

--errors-only
    Only show errors (skip warnings)

--json
    Output validation results in JSON format

-h, --help
    Print help Arguments:

<TASKS>
    Tasks to validate If not specified, validates all tasks

MISE TEST-TOOL
Test a tool installs and executes

Usage: mise test-tool [OPTIONS] [<TOOLS>] ...

Options:

-a, --all
    Test every tool specified in registry/

-j, --jobs <JOBS>
    Number of tool tests to run in parallel Values below 1 are treated as 1 [default: 4]
    Environment: MISE_TEST_TOOL_JOBS

--all-config
    Test all tools specified in config files

--include-non-defined
    Also test tools not defined in registry/, guessing how to test it

--raw
    Connect backend install command stdin/stdout/stderr directly to the terminal Implies --jobs=1

-h, --help
    Print help Arguments:

<TOOLS>
    Tool(s) to test

MISE TOKEN
Display git provider tokens mise will use

Usage: mise token [OPTIONS] <COMMAND>

Options:

-h, --help
    Print help

MISE TOKEN FORGEJO
Display the Forgejo token mise will use for a given host Shows which token source mise would use, useful for debugging authentication issues. The token is masked by default.

Usage: mise token forgejo [OPTIONS] [<HOST>]

Options:

--unmask
    Show the full unmasked token

-h, --help
    Print help Arguments:

<HOST>
    Forgejo hostname
    Default: codeberg.org

MISE TOKEN GITHUB
Display the GitHub token mise will use for a given host Shows which token source mise would use, useful for debugging authentication issues. The token is masked by default.

Usage: mise token github [OPTIONS] [<HOST>]

Options:

--oauth
    Resolve only via the native GitHub OAuth source (cache, refresh, or device-code flow), bypassing other token sources

--raw
    Print only the token value

--refresh
    Mint a fresh OAuth token even if the cached one has not expired, via the refresh-token grant or a new device-code flow. Use after changing the GitHub App's installations or permissions: cached tokens keep their original access until they expire

--unmask
    Show the full unmasked token

-h, --help
    Print help Arguments:

<HOST>
    GitHub hostname
    Default: github.com

MISE TOKEN GITLAB
Display the GitLab token mise will use for a given host Shows which token source mise would use, useful for debugging authentication issues. The token is masked by default.

Usage: mise token gitlab [OPTIONS] [<HOST>]

Options:

--unmask
    Show the full unmasked token

-h, --help
    Print help Arguments:

<HOST>
    GitLab hostname
    Default: gitlab.com

MISE TOOL
Gets information about a tool

Usage: mise tool [OPTIONS] <TOOL>

Options:

-J, --json
    Output in JSON format

--active
    Only show active versions

--backend
    Only show backend field

--config-source
    Only show config source

--description
    Only show description field

--installed
    Only show installed versions

--requested
    Only show requested versions

--tool-options
    Only show tool options

-h, --help
    Print help Arguments:

<TOOL>
    Tool name to get information about

MISE TOOL-STUB
Execute a tool stub Tool stubs are executable files containing TOML configuration that specify which tool to run and how to run it. They provide a convenient way to create portable, self-contained executables that automatically manage tool installation and execution. A tool stub consists of: - A shebang line: #!/usr/bin/env -S mise tool-stub - TOML configuration specifying the tool, version, and options - Optional comments describing the tool's purpose Example stub file: ```toml #!/usr/bin/env -S mise tool-stub # Node.js v20 development environment tool = "node" version = "20.0.0" bin = "node" ``` The stub will automatically install the specified tool version if missing and execute it with any arguments passed to the stub. For more information, see: https://mise.jdx.dev/dev-tools/tool-stubs.html

Usage: mise tool-stub <FILE> [<ARGS>] ...

Arguments:

<FILE>
    Path to the TOML tool stub file to execute The stub file must contain TOML configuration specifying the tool and version to run. At minimum, it should specify a 'version' field. Other common fields include 'tool', 'bin', and backend-specific options.

<ARGS>
    Arguments to pass to the tool All arguments after the stub file path will be forwarded to the underlying tool. Use '--' to separate mise arguments from tool arguments if needed.

MISE TRUST
Marks a config file as trusted This means mise is allowed to parse the file when it needs to read config that may execute code or affect the environment. Without trust, mise may prompt, skip the config in some discovery paths, or fail with an untrusted-config error when it cannot prompt. In normal mode, commands that execute project-defined behavior (`mise run`, naked task invocations such as `mise <TASK>`, `mise install`, `mise exec`, and `mise watch`) automatically trust their active config. Paranoid mode requires explicit, content-bound trust for every non-global config. In normal mode, safe config files do not require trust: files that only contain `min_version`, `[tools]` entries with plain version strings (or arrays of them), and `[tasks]` without templates or tool options. Trust is shared across git worktrees: a config file inside a linked worktree is trusted when the equivalent path in the repository's main checkout has been trusted. Paranoid mode disables this sharing since worktrees can check out branches with different config contents.

Usage: mise trust [OPTIONS] [<CONFIG_FILE>]

Options:

-a, --all
    Trust all config files in the current directory, its parents, and its subdirectories Subdirectories are walked respecting .gitignore, skipping hidden directories and common build/dependency directories (node_modules, vendor, target, dist, build).

--ignore
    Do not trust this config and ignore it in the future

--show
    Show the trusted status of config files from the current directory and its parents. Does not trust or untrust any files.

--untrust
    Remove explicit trust for this config

-h, --help
    Print help Arguments:

<CONFIG_FILE>
    The config file whose trust status to change

MISE UNINSTALL
Removes installed tool versions This only removes the installed version, it does not modify mise.toml.

Usage: mise uninstall [OPTIONS] [<INSTALLED_TOOL@VERSION>] ...

Options:

-a, --all
    Delete all installed versions

-n, --dry-run
    Do not actually delete anything

--dry-run-code
    Like --dry-run but exits with code 1 if there are tools to uninstall This is useful for scripts to check if tools need to be uninstalled.

-h, --help
    Print help Arguments:

<INSTALLED_TOOL@VERSION>
    Tool(s) to remove

MISE UNSET
Remove environment variable(s) from the config file. By default, this command modifies `mise.toml` in the current directory.

Usage: mise unset [OPTIONS] [<ENV_KEY>] ...

Options:

-f, --file, --path <FILE>
    Specify a file to use instead of `mise.toml` Can be a file path or directory. If a directory is provided, will create/use mise.toml in that directory. Defaults to [`MISE_DEFAULT_CONFIG_FILENAME`](https://mise.jdx.dev/configuration.html#mise_default_config_filename) environment variable, or `mise.toml`. Use [`MISE_GLOBAL_CONFIG_FILE`](https://mise.jdx.dev/configuration.html#mise_global_config_file) to choose a different global config path.

-g, --global
    Use the global config file

-h, --help
    Print help Arguments:

<ENV_KEY>
    Environment variable(s) to remove e.g.: NODE_ENV

MISE UNTRUST
Remove explicit trust for a config

Usage: mise untrust [OPTIONS] [<CONFIG_FILE>]

Options:

-h, --help
    Print help Arguments:

<CONFIG_FILE>
    The config file to untrust

MISE UNUSE
Removes installed tool versions from mise.toml By default, this will use the `mise.toml` file that has the tool defined. If multiple config files exist (e.g., both `mise.toml` and `mise.local.toml`), the lowest precedence file (`mise.toml`) will be used. See https://mise.jdx.dev/configuration.html#target-file-for-write-operations In the following order:
  - If `--global` is set, it will use the global config file.
  - If `--path` is set, it will use the config file at the given path.
  - If `--env` is set, it will use `mise.<env>.toml`.
  - If [`MISE_DEFAULT_CONFIG_FILENAME`](https://mise.jdx.dev/configuration.html#mise_default_config_filename) is set, it will use that instead.
  - If `MISE_OVERRIDE_CONFIG_FILENAMES` is set, it will the first from that list.
  - Otherwise just "mise.toml" or global config if cwd is home directory. Use [`MISE_GLOBAL_CONFIG_FILE`](https://mise.jdx.dev/configuration.html#mise_global_config_file) to choose a different global config path. Will also prune the installed version if no other configurations are using it.

Usage: mise unuse [OPTIONS] <INSTALLED_TOOL@VERSION> ...

Options:

-e, --env <ENV>
    Create/modify an environment-specific config file like .mise.<env>.toml

-g, --global
    Use the global config file (`~/.config/mise/config.toml`) instead of the local one

-p, --path, --file <PATH>
    Specify a path to a config file or directory If a directory is specified, it will look for a config file in that directory following the rules above.

--no-prune
    Do not also prune the installed version

-h, --help
    Print help Arguments:

<INSTALLED_TOOL@VERSION>
    Tool(s) to remove

MISE UPGRADE
Upgrades outdated tools By default, this keeps the range specified in mise.toml. So if you have node@20 set, it will upgrade to the latest 20.x.x version available. See the `--bump` flag to use the latest version and bump the version in mise.toml. This will update mise.lock if it is enabled, see https://mise.jdx.dev/configuration/settings.html#lockfile

Usage: mise upgrade [OPTIONS] [<INSTALLED_TOOL@VERSION>] ...

Options:

-b, --bump
    Upgrades to the latest version available, bumping the version in mise.toml For example, if you have `node = "20.0.0"` in your mise.toml but 22.1.0 is the latest available, this will install 22.1.0 and set `node = "22.1.0"` in your config. It keeps the same precision as what was there before, so if you instead had `node = "20"`, it would change your config to `node = "22"`.

-i, --interactive
    Display multiselect menu to choose which tools to upgrade

-j, --jobs <JOBS>
    Number of jobs to run in parallel Values below 1 are treated as 1 [default: 4]
    Environment: MISE_JOBS

-l  Deprecated shorthand for --bump

-n, --dry-run
    Just print what would be done, don't actually do it

-x, --exclude <INSTALLED_TOOL>
    Tool(s) to exclude from upgrading e.g.: go python

--dry-run-code
    Like --dry-run but exits with code 1 if there are outdated tools This is useful for scripts to check if tools need to be upgraded.

--inactive
    Upgrade all tools, including installed-but-inactive tools not present in the current config

--local
    Only upgrade tools defined in local config files This will only upgrade tools that are defined in project-local mise.toml and will skip tools defined in the global config (~/.config/mise/config.toml).

--minimum-release-age <MINIMUM_RELEASE_AGE>
    Only upgrade to versions released before this date or older than this duration Supports absolute dates like "2024-06-01" and relative durations like "90d" or "1y". This can be useful for reproducibility or security purposes. This only affects fuzzy version matches like "20" or "latest". Explicitly pinned versions like "22.5.0" are not filtered.

--monorepo
    Placeholder for future monorepo upgrades; `mise upgrade --monorepo` is not implemented yet.

--no-prune
    Do not uninstall the versions that were upgraded away from The old version is left in place and is not scheduled for removal. Use this when something outside mise points at the install directory. Set `upgrade.auto_prune = false` to make this the default.

--prune
    Immediately uninstall the versions that were upgraded away from Use this to bypass `upgrade.prune_after`, or to override `upgrade.auto_prune = false` for a single run.

--raw
    Connect backend install command stdin/stdout/stderr directly to the terminal Implies --jobs=1

-h, --help
    Print help Arguments:

<INSTALLED_TOOL@VERSION>
    Tool(s) to upgrade e.g.: node@20 python@3.10 If not specified, all current tools will be upgraded

MISE USE
Installs a tool and adds the version to mise.toml. This will install the tool version if it is not already installed. By default, this will use a `mise.toml` file in the current directory. If multiple config files exist (e.g., both `mise.toml` and `mise.local.toml`), the lowest precedence file (`mise.toml`) will be used. See https://mise.jdx.dev/configuration.html#target-file-for-write-operations In the following order:
  - If `--global` is set, it will use the global config file.
  - If `--path` is set, it will use the config file at the given path.
  - If `--env` is set, it will use `mise.<env>.toml`.
  - If [`MISE_DEFAULT_CONFIG_FILENAME`](https://mise.jdx.dev/configuration.html#mise_default_config_filename) is set, it will use that instead.
  - If `MISE_OVERRIDE_CONFIG_FILENAMES` is set, it will the first from that list.
  - Otherwise just "mise.toml" or global config if cwd is home directory. Use [`MISE_GLOBAL_CONFIG_FILE`](https://mise.jdx.dev/configuration.html#mise_global_config_file) to choose a different global config path. Use the `--global` flag to use the global config file instead.

Usage: mise use [OPTIONS] [TOOL@VERSION]…

Options:

-e, --env <ENV>
    Create/modify an environment-specific config file like .mise.<env>.toml

-f, --force
    Force reinstall even if already installed

-g, --global
    Use the global config file (`~/.config/mise/config.toml`) instead of the local one

-j, --jobs <JOBS>
    Number of jobs to run in parallel Values below 1 are treated as 1 [default: 4]
    Environment: MISE_JOBS

-n, --dry-run
    Perform a dry run, showing what would be installed and modified without making changes

-p, --path <PATH>
    Specify a path to a config file or directory If a directory is specified, it will look for a config file in that directory following the rules above.

--dry-run-code
    Like --dry-run but exits with code 1 if there are changes to make This is useful for scripts to check if tools need to be added or removed.

--fuzzy
    Save fuzzy version to config file e.g.: `mise use --fuzzy node@20` will save 20 as the version this is the default behavior unless `MISE_PIN=1`

--minimum-release-age <MINIMUM_RELEASE_AGE>
    Only install versions released before this date or older than this duration Supports absolute dates like "2024-06-01" and relative durations like "90d" or "1y".

--pin
    Save the resolved concrete version to the config file If the request exactly matches an available release, that release is preferred over installed fuzzy matches. Use `prefix:` to explicitly request recursive prefix matching. e.g.: `mise use --pin node@20` will save the resolved `20.x.y` version Set `MISE_PIN=1` to make this the default behavior Consider using mise.lock as a better alternative to pinning in mise.toml: https://mise.jdx.dev/configuration/settings.html#lockfile

--raw
    Connect backend install command stdin/stdout/stderr directly to the terminal Implies `--jobs=1`

--remove <TOOL>
    Remove the tool(s) from config file

-h, --help
    Print help

--postinstall <COMMAND>
    Command to run after installing this tool Arguments:

<TOOL@VERSION>
    Tool to add to config file e.g.: node@20, cargo:ripgrep@latest npm:prettier@3 If no version is specified, it will default to @latest Tool options can be set with this syntax:
        mise use ubi:BurntSushi/ripgrep[exe=rg]

MISE VERSION
Display the version of mise Displays the version, os, architecture, and the date of the build. If the version is out of date, it will display a warning.

Usage: mise version [OPTIONS]

Options:

-J, --json
    Print the version information in JSON format

-h, --help
    Print help

MISE WATCH
Run task(s) and watch for changes to rerun it This command uses the `watchexec` tool to watch for changes to files and rerun the specified task(s). It must be installed for this command to work, but you can install it with `mise use -g watchexec@latest`. For more advanced process management (daemon management, auto-restart, readiness checks, cron scheduling), see mise's sister project: https://pitchfork.jdx.dev

Usage: mise watch [OPTIONS] [<TASK>] [<ARGS>] ...

Options:

-t, --task-flag <TASK_FLAG>
    Tasks to run

-g, --glob <GLOB>
    Files to watch Defaults to sources from the task(s)

--skip-deps
    Run only the specified tasks skipping all dependencies

-w, --watch <PATH>
    Watch a specific file or directory By default, Watchexec watches the current directory. When watching a single file, it's often better to watch the containing directory instead, and filter on the filename. Some editors may replace the file with a new one when saving, and some platforms may not detect that or further changes. Upon starting, Watchexec resolves a "project origin" from the watched paths. See the help for '--project-origin' for more information. This option can be specified multiple times to watch multiple files or directories. The special value '/dev/null', provided as the only path watched, will cause Watchexec to not watch any paths. Other event sources (like signals or key events) may still be used.

-W, --watch-non-recursive <PATH>
    Watch a specific directory, non-recursively Unlike '-w', folders watched with this option are not recursed into. This option can be specified multiple times to watch multiple directories non-recursively.

-F, --watch-file <PATH>
    Watch files and directories from a file Each line in the file will be interpreted as if given to '-w'. For more complex uses (like watching non-recursively), use the argfile capability: build a file containing command-line options and pass it to watchexec with `@path/to/argfile`. The special value '-' will read from STDIN; this in incompatible with '--stdin-quit'.

-c, --clear <MODE>
    Clear screen before running command If this doesn't completely clear the screen, try '--clear=reset'.

-o, --on-busy-update <MODE>
    What to do when receiving events while the command is running Default is to 'do-nothing', which ignores events while the command is running, so that changes that occur due to the command are ignored, like compilation outputs. You can also use 'queue' which will run the command once again when the current run has finished if any events occur while it's running, or 'restart', which terminates the running command and starts a new one. Finally, there's 'signal', which only sends a signal; this can be useful with programs that can reload their configuration without a full restart. The signal can be specified with the '--signal' option.
    Default: do-nothing

-r, --restart
    Restart the process if it's still running This is a shorthand for '--on-busy-update=restart'.

-s, --signal <SIGNAL>
    Send a signal to the process when it's still running Specify a signal to send to the process when it's still running. This implies '--on-busy-update=signal'; otherwise the signal used when that mode is 'restart' is controlled by '--stop-signal'. See the long documentation for '--stop-signal' for syntax. Signals are not supported on Windows at the moment, and will always be overridden to 'kill'. See '--stop-signal' for more on Windows "signals".

--stop-signal <SIGNAL>
    Signal to send to stop the command This is used by 'restart' and 'signal' modes of '--on-busy-update' (unless '--signal' is provided). The restart behaviour is to send the signal, wait for the command to exit, and if it hasn't exited after some time (see '--timeout-stop'), forcefully terminate it. The default on unix is "SIGTERM". Input is parsed as a full signal name (like "SIGTERM"), a short signal name (like "TERM"), or a signal number (like "15"). All input is case-insensitive. On Windows this option is technically supported but only supports the "KILL" event, as Watchexec cannot yet deliver other events. Windows doesn't have signals as such; instead it has termination (here called "KILL" or "STOP") and "CTRL+C", "CTRL+BREAK", and "CTRL+CLOSE" events. For portability the unix signals "SIGKILL", "SIGINT", "SIGTERM", and "SIGHUP" are respectively mapped to these.

--stop-timeout <TIMEOUT>
    Time to wait for the command to exit gracefully This is used by the 'restart' mode of '--on-busy-update'. After the graceful stop signal is sent, Watchexec will wait for the command to exit. If it hasn't exited after this time, it is forcefully terminated. Takes a unit-less value in seconds, or a time span value such as "5min 20s". Providing a unit-less value is deprecated and will warn; it will be an error in the future. The default is 10 seconds. Set to 0 to immediately force-kill the command. This has no practical effect on Windows as the command is always forcefully terminated; see '--stop-signal' for why.
    Default: 10s

--map-signal <SIGNAL:SIGNAL>
    Translate signals from the OS to signals to send to the command Takes a pair of signal names, separated by a colon, such as "TERM:INT" to map SIGTERM to SIGINT. The first signal is the one received by watchexec, and the second is the one sent to the command. The second can be omitted to discard the first signal, such as "TERM:" to not do anything on SIGTERM. If SIGINT or SIGTERM are mapped, then they no longer quit Watchexec. Besides making it hard to quit Watchexec itself, this is useful to send pass a Ctrl-C to the command without also terminating Watchexec and the underlying program with it, e.g. with "INT:INT". This option can be specified multiple times to map multiple signals. Signal syntax is case-insensitive for short names (like "TERM", "USR2") and long names (like "SIGKILL", "SIGHUP"). Signal numbers are also supported (like "15", "31"). On Windows, the forms "STOP", "CTRL+C", and "CTRL+BREAK" are also supported to receive, but Watchexec cannot yet deliver other "signals" than a STOP.

-d, --debounce <TIMEOUT>
    Time to wait for new events before taking action When an event is received, Watchexec will wait for up to this amount of time before handling it (such as running the command). This is essential as what you might perceive as a single change may actually emit many events, and without this behaviour, Watchexec would run much too often. Additionally, it's not infrequent that file writes are not atomic, and each write may emit an event, so this is a good way to avoid running a command while a file is partially written. An alternative use is to set a high value (like "30min" or longer), to save power or bandwidth on intensive tasks, like an ad-hoc backup script. In those use cases, note that every accumulated event will build up in memory. Takes a unit-less value in milliseconds, or a time span value such as "5sec 20ms". Providing a unit-less value is deprecated and will warn; it will be an error in the future. The default is 50 milliseconds. Setting to 0 is highly discouraged.
    Default: 50ms

--stdin-quit
    Exit when stdin closes This watches the stdin file descriptor for EOF, and exits Watchexec gracefully when it is closed. This is used by some process managers to avoid leaving zombie processes around.

--no-vcs-ignore
    Don't load gitignores Among other VCS exclude files, like for Mercurial, Subversion, Bazaar, DARCS, Fossil. Note that Watchexec will detect which of these is in use, if any, and only load the relevant files. Both global (like '~/.gitignore') and local (like '.gitignore') files are considered. This option is useful if you want to watch files that are ignored by Git.

--no-project-ignore
    Don't load project-local ignores This disables loading of project-local ignore files, like '.gitignore' or '.ignore' in the watched project. This is contrasted with '--no-vcs-ignore', which disables loading of Git and other VCS ignore files, and with '--no-global-ignore', which disables loading of global or user ignore files, like '~/.gitignore' or '~/.config/watchexec/ignore'. Supported project ignore files:
      - Git: .gitignore at project root and child directories, .git/info/exclude, and the file pointed to by `core.excludesFile` in .git/config.
      - Mercurial: .hgignore at project root and child directories.
      - Bazaar: .bzrignore at project root.
      - Darcs: _darcs/prefs/boring
      - Fossil: .fossil-settings/ignore-glob
      - Ripgrep/Watchexec/generic: .ignore at project root and child directories. VCS ignore files (Git, Mercurial, Bazaar, Darcs, Fossil) are only used if the corresponding VCS is discovered to be in use for the project/origin. For example, a .bzrignore in a Git repository will be discarded.

--no-global-ignore
    Don't load global ignores This disables loading of global or user ignore files, like '~/.gitignore', '~/.config/watchexec/ignore', or '%APPDATA%\Bazaar\2.0\ignore'. Contrast with '--no-vcs-ignore' and '--no-project-ignore'. Supported global ignore files
      - Git (if core.excludesFile is set): the file at that path
      - Git (otherwise): the first found of $XDG_CONFIG_HOME/git/ignore, %APPDATA%/.gitignore, %USERPROFILE%/.gitignore, $HOME/.config/git/ignore, $HOME/.gitignore.
      - Bazaar: the first found of %APPDATA%/Bazaar/2.0/ignore, $HOME/.bazaar/ignore.
      - Watchexec: the first found of $XDG_CONFIG_HOME/watchexec/ignore, %APPDATA%/watchexec/ignore, %USERPROFILE%/.watchexec/ignore, $HOME/.watchexec/ignore. Like for project files, Git and Bazaar global files will only be used for the corresponding VCS as used in the project.

--no-default-ignore
    Don't use internal default ignores Watchexec has a set of default ignore patterns, such as editor swap files, `*.pyc`, `*.pyo`, `.DS_Store`, `.bzr`, `_darcs`, `.fossil-settings`, `.git`, `.hg`, `.pijul`, `.svn`, and Watchexec log files.

--no-discover-ignore
    Don't discover ignore files at all This is a shorthand for '--no-global-ignore', '--no-vcs-ignore', '--no-project-ignore', but even more efficient as it will skip all the ignore discovery mechanisms from the get go. Note that default ignores are still loaded, see '--no-default-ignore'.

--ignore-nothing
    Don't ignore anything at all This is a shorthand for '--no-discover-ignore', '--no-default-ignore'. Note that ignores explicitly loaded via other command line options, such as '--ignore' or '--ignore-file', will still be used.

-p, --postpone
    Wait until first change before running command By default, Watchexec will run the command once immediately. With this option, it will instead wait until an event is detected before running the command as normal.

--delay-run <DURATION>
    Sleep before running the command This option will cause Watchexec to sleep for the specified amount of time before running the command, after an event is detected. This is like using "sleep 5 && command" in a shell, but portable and slightly more efficient. Takes a unit-less value in seconds, or a time span value such as "2min 5s". Providing a unit-less value is deprecated and will warn; it will be an error in the future.

--poll <INTERVAL>
    Poll for filesystem changes By default, and where available, Watchexec uses the operating system's native file system watching capabilities. This option disables that and instead uses a polling mechanism, which is less efficient but can work around issues with some file systems (like network shares) or edge cases. Optionally takes a unit-less value in milliseconds, or a time span value such as "2s 500ms", to use as the polling interval. If not specified, the default is 30 seconds. Providing a unit-less value is deprecated and will warn; it will be an error in the future. Aliased as '--force-poll'.

--shell <SHELL>
    Use a different shell By default, Watchexec will use '$SHELL' if it's defined or a default of 'sh' on Unix-likes, and either 'pwsh', 'powershell', or 'cmd' (CMD.EXE) on Windows, depending on what Watchexec detects is the running shell. With this option, you can override that and use a different shell, for example one with more features or one which has your custom aliases and functions. If the value has spaces, it is parsed as a command line, and the first word used as the shell program, with the rest as arguments to the shell. The command is run with the '-c' flag (except for 'cmd' on Windows, where it's '/C'). The special value 'none' can be used to disable shell use entirely. In that case, the command provided to Watchexec will be parsed, with the first word being the executable and the rest being the arguments, and executed directly. Note that this parsing is rudimentary, and may not work as expected in all cases. Using 'none' is a little more efficient and can enable a stricter interpretation of the input, but it also means that you can't use shell features like globbing, redirection, control flow, logic, or pipes. Examples: Use without shell:
      $ watchexec -n -- zsh -x -o shwordsplit scr Use with powershell core:
      $ watchexec --shell=pwsh -- Test-Connection localhost Use with CMD.exe:
      $ watchexec --shell=cmd -- dir Use with a different unix shell:
      $ watchexec --shell=bash -- 'echo $BASH_VERSION' Use with a unix shell and options:
      $ watchexec --shell='zsh -x -o shwordsplit' -- scr

-n  Shorthand for '--shell=none'

--emit-events-to <MODE>
    Configure event emission Watchexec can emit event information when running a command, which can be used by the child process to target specific changed files. One thing to take care with is assuming inherent behaviour where there is only chance. Notably, it could appear as if the `RENAMED` variable contains both the original and the new path being renamed. In previous versions, it would even appear on some platforms as if the original always came before the new. However, none of this was true. It's impossible to reliably and portably know which changed path is the old or new, "half" renames may appear (only the original, only the new), "unknown" renames may appear (change was a rename, but whether it was the old or new isn't known), rename events might split across two debouncing boundaries, and so on. This option controls where that information is emitted. It defaults to 'none', which doesn't emit event information at all. The other options are 'environment' (deprecated), 'stdio', 'file', 'json-stdio', and 'json-file'. The 'stdio' and 'file' modes are text-based: 'stdio' writes absolute paths to the stdin of the command, one per line, each prefixed with `create:`, `remove:`, `rename:`, `modify:`, or `other:`, then closes the handle; 'file' writes the same thing to a temporary file, and its path is given with the $WATCHEXEC_EVENTS_FILE environment variable. There are also two JSON modes, which are based on JSON objects and can represent the full set of events Watchexec handles. Here's an example of a folder being created on Linux: ```json
      {
        "tags": [
          {
            "kind": "path",
            "absolute": "/home/user/your/new-folder",
            "filetype": "dir"
          },
          {
            "kind": "fs",
            "simple": "create",
            "full": "Create(Folder)"
          },
          {
            "kind": "source",
            "source": "filesystem",
          }
        ],
        "metadata": {
          "notify-backend": "inotify"
        }
      } ``` The fields are as follows:
      - `tags`, structured event data.
      - `tags[].kind`, which can be:
        * 'path', along with:
          + `absolute`, an absolute path.
          + `filetype`, a file type if known ('dir', 'file', 'symlink', 'other').
        * 'fs':
          + `simple`, the "simple" event type ('access', 'create', 'modify', 'remove', or 'other').
          + `full`, the "full" event type, which is too complex to fully describe here, but looks like 'General(Precise(Specific))'.
        * 'source', along with:
          + `source`, the source of the event ('filesystem', 'keyboard', 'mouse', 'os', 'time', 'internal').
        * 'keyboard', along with:
          + `keycode`. Currently only the value 'eof' is supported.
        * 'process', for events caused by processes:
          + `pid`, the process ID.
        * 'signal', for signals sent to Watchexec:
          + `signal`, the normalised signal name ('hangup', 'interrupt', 'quit', 'terminate', 'user1', 'user2').
        * 'completion', for when a command ends:
          + `disposition`, the exit disposition ('success', 'error', 'signal', 'stop', 'exception', 'continued').
          + `code`, the exit, signal, stop, or exception code.
      - `metadata`, additional information about the event. The 'json-stdio' mode will emit JSON events to the standard input of the command, one per line, then close stdin. The 'json-file' mode will create a temporary file, write the events to it, and provide the path to the file with the $WATCHEXEC_EVENTS_FILE environment variable. Finally, the 'environment' mode was the default until 2.0. It sets environment variables with the paths of the affected files, for filesystem events: $WATCHEXEC_COMMON_PATH is set to the longest common path of all of the below variables, and so should be prepended to each path to obtain the full/real path. Then:
      - $WATCHEXEC_CREATED_PATH is set when files/folders were created
      - $WATCHEXEC_REMOVED_PATH is set when files/folders were removed
      - $WATCHEXEC_RENAMED_PATH is set when files/folders were renamed
      - $WATCHEXEC_WRITTEN_PATH is set when files/folders were modified
      - $WATCHEXEC_META_CHANGED_PATH is set when files/folders' metadata were modified
      - $WATCHEXEC_OTHERWISE_CHANGED_PATH is set for every other kind of pathed event Multiple paths are separated by the system path separator, ';' on Windows and ':' on unix. Within each variable, paths are deduplicated and sorted in binary order (i.e. neither Unicode nor locale aware). This is the legacy mode, is deprecated, and will be removed in the future. The environment is a very restricted space, while also limited in what it can usefully represent. Large numbers of files will either cause the environment to be truncated, or may error or crash the process entirely. The $WATCHEXEC_COMMON_PATH is also unintuitive, as demonstrated by the multiple confused queries that have landed in my inbox over the years.
    Default: none

--only-emit-events
    Only emit events to stdout, run no commands. This is a convenience option for using Watchexec as a file watcher, without running any commands. It is almost equivalent to using `cat` as the command, except that it will not spawn a new process for each event. This option requires `--emit-events-to` to be set, and restricts the available modes to `stdio` and `json-stdio`, modifying their behaviour to write to stdout instead of the stdin of the command.

-E, --env <KEY=VALUE>
    Add env vars to the command This is a convenience option for setting environment variables for the command, without setting them for the Watchexec process itself. Use key=value syntax. Multiple variables can be set by repeating the option.

--wrap-process <MODE>
    Configure how the process is wrapped By default, Watchexec will run the command in a session on macOS, in a process group on other Unix platforms, and in a Job Object in Windows. Some Unix programs prefer running in a session, while others do not work in a process group. Use 'group' to use a process group, 'session' to use a process session, and 'none' to run the command directly. On Windows, either of 'group' or 'session' will use a Job Object.

-N, --notify
    Alert when commands start and end With this, Watchexec will emit a desktop notification when a command starts and ends, on supported platforms. On unsupported platforms, it may silently do nothing, or log a warning.

--color <MODE>
    When to use terminal colours Setting the environment variable `NO_COLOR` to any value is equivalent to `--color=never`.
    Default: auto

--timings
    Print how long the command took to run This may not be exactly accurate, as it includes some overhead from Watchexec itself. Use the `time` utility, high-precision timers, or benchmarking tools for more accurate results.

-q, --quiet
    Don't print starting and stopping messages By default Watchexec will print a message when the command starts and stops. This option disables this behaviour, so only the command's output, warnings, and errors will be printed.

--bell
    Ring the terminal bell on command completion

--project-origin <DIRECTORY>
    Set the project origin Watchexec will attempt to discover the project's "origin" (or "root") by searching for a variety of markers, like files or directory patterns. It does its best but sometimes gets it it wrong, and you can override that with this option. The project origin is used to determine the path of certain ignore files, which VCS is being used, the meaning of a leading '/' in filtering patterns, and maybe more in the future. When set, Watchexec will also not bother searching, which can be significantly faster.

--workdir <DIRECTORY>
    Set the working directory By default, the working directory of the command is the working directory of Watchexec. You can change that with this option. Note that paths may be less intuitive to use with this.

-e, --exts <EXTENSIONS>
    Filename extensions to filter to This is a quick filter to only emit events for files with the given extensions. Extensions can be given with or without the leading dot (e.g. 'js' or '.js'). Multiple extensions can be given by repeating the option or by separating them with commas.

-f, --filter <PATTERN>
    Filename patterns to filter to Provide a glob-like filter pattern, and only events for files matching the pattern will be emitted. Multiple patterns can be given by repeating the option. Events that are not from files (e.g. signals, keyboard events) will pass through untouched.

--filter-file <PATH>
    Files to load filters from Provide a path to a file containing filters, one per line. Empty lines and lines starting with '#' are ignored. Uses the same pattern format as the '--filter' option. This can also be used via the $WATCHEXEC_FILTER_FILES environment variable.
    Environment: WATCHEXEC_FILTER_FILES

-J, --filter-prog <EXPRESSION>
    [experimental] Filter programs. /!\ This option is EXPERIMENTAL and may change and/or vanish without notice. Provide your own custom filter programs in jaq (similar to jq) syntax. Programs are given an event in the same format as described in '--emit-events-to' and must return a boolean. Invalid programs will make watchexec fail to start; use '-v' to see program runtime errors. In addition to the jaq stdlib, watchexec adds some custom filter definitions:
      - 'path | file_meta' returns file metadata or null if the file does not exist.
      - 'path | file_size' returns the size of the file at path, or null if it does not exist.
      - 'path | file_read(bytes)' returns a string with the first n bytes of the file at path.
        If the file is smaller than n bytes, the whole file is returned. There is no filter to
        read the whole file at once to encourage limiting the amount of data read and processed.
      - 'string | hash', and 'path | file_hash' return the hash of the string or file at path.
        No guarantee is made about the algorithm used: treat it as an opaque value.
      - 'any | kv_store(key)', 'kv_fetch(key)', and 'kv_clear' provide a simple key-value store.
        Data is kept in memory only, there is no persistence. Consistency is not guaranteed.
      - 'any | printout', 'any | printerr', and 'any | log(level)' will print or log any given
        value to stdout, stderr, or the log (levels = error, warn, info, debug, trace), and
        pass the value through (so '[1] | log("debug") | .[]' will produce a '1' and log '[1]'). All filtering done with such programs, and especially those using kv or filesystem access, is much slower than the other filtering methods. If filtering is too slow, events will back up and stall watchexec. Take care when designing your filters. If the argument to this option starts with an '@', the rest of the argument is taken to be the path to a file containing a jaq program. Jaq programs are run in order, after all other filters, and short-circuit: if a filter (jaq or not) rejects an event, execution stops there, and no other filters are run. Additionally, they stop after outputting the first value, so you'll want to use 'any' or 'all' when iterating, otherwise only the first item will be processed, which can be quite confusing! Find user-contributed programs or submit your own useful ones at <https://github.com/watchexec/watchexec/discussions/592>. ## Examples: Regexp ignore filter on paths:
      'all(.tags[] | select(.kind == "path"); .absolute | test("[.]test[.]js$")) | not' Pass any event that creates a file:
      'any(.tags[] | select(.kind == "fs"); .simple == "create")' Pass events that touch executable files:
      'any(.tags[] | select(.kind == "path" && .filetype == "file"); .absolute | metadata | .executable)' Ignore files that start with shebangs:
      'any(.tags[] | select(.kind == "path" && .filetype == "file"); .absolute | read(2) == "#!") | not'

-i, --ignore <PATTERN>
    Filename patterns to filter out Provide a glob-like filter pattern, and events for files matching the pattern will be excluded. Multiple patterns can be given by repeating the option. Events that are not from files (e.g. signals, keyboard events) will pass through untouched.

--ignore-file <PATH>
    Files to load ignores from Provide a path to a file containing ignores, one per line. Empty lines and lines starting with '#' are ignored. Uses the same pattern format as the '--ignore' option. This can also be used via the $WATCHEXEC_IGNORE_FILES environment variable.
    Environment: WATCHEXEC_IGNORE_FILES

--fs-events <EVENTS>
    Filesystem events to filter to This is a quick filter to only emit events for the given types of filesystem changes. Choose from 'access', 'create', 'remove', 'rename', 'modify', 'metadata'. Multiple types can be given by repeating the option or by separating them with commas. By default, this is all types except for 'access'. This may apply filtering at the kernel level when possible, which can be more efficient, but may be more confusing when reading the logs.
    Default: create,remove,rename,modify,metadata

--no-meta
    Don't emit fs events for metadata changes This is a shorthand for '--fs-events create,remove,rename,modify'. Using it alongside the '--fs-events' option is non-sensical and not allowed.

--print-events
    Print events that trigger actions This prints the events that triggered the action when handling it (after debouncing), in a human readable form. This is useful for debugging filters. Use '-vvv' instead when you need more diagnostic information.

--manual
    Show the manual page This shows the manual page for Watchexec, if the output is a terminal and the 'man' program is available. If not, the manual page is printed to stdout in ROFF format (suitable for writing to a watchexec.1 file).

-h, --help
    Print help Arguments:

<TASK>
    Tasks to run Can specify multiple tasks by separating with `:::` e.g.: `mise run task1 arg1 arg2 ::: task2 arg1 arg2` Defaults to `default`

<ARGS>
    Task and arguments to run

MISE WHERE
Display the installation path for a tool The tool must be installed for this to work.

Usage: mise where [OPTIONS] <TOOL@VERSION> [<ASDF_VERSION>]

Options:

-h, --help
    Print help Arguments:

<TOOL@VERSION>
    Tool(s) to look up e.g.: ruby@3 if "@<PREFIX>" is specified, it will show the latest installed version that matches the prefix otherwise, it will show the current, active installed version

<ASDF_VERSION>
    the version prefix to use when querying the latest version same as the first argument after the "@" used for asdf compatibility

MISE WHICH
Shows the path that a tool's bin points to. Use this to figure out what version of a tool is currently active.

Usage: mise which [OPTIONS] [<BIN_NAME>]

Options:

-t, --tool <TOOL@VERSION>
    Use a specific tool@version e.g.: `mise which npm --tool=node@20`

--complete

--plugin
    Show the plugin name instead of the path

--version
    Show the version instead of the path

-h, --help
    Print help Arguments:

<BIN_NAME>
    The bin to look up

AUTHOR
Jeff Dickey <@jdx>