Back to Mise

`mise plugins install`

docs/cli/plugins/install.md

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

mise plugins install

  • Usage: mise plugins install [FLAGS] [NEW_PLUGIN] [GIT_URL]
  • Aliases: i, a, add
  • Effect: modifies state
  • Source code: src/cli/plugins/install.rs

Install a plugin from a configured source, Git URL, or supported archive

Most registry tools use built-in backends and need no plugin. When a selected backend does require a plugin, mise normally installs it with the tool. Use this command to install it ahead of time or choose a custom source.

A Git URL may end in #ref to select a plugin commit, tag, or branch. This selects the plugin implementation, separately from the tool version installed by mise use.

Arguments

  • [NEW_PLUGIN] — The name of the plugin to install Use a configured plugin name, or supply a source URL below
  • [GIT_URL] — The git url of the plugin

Flags

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

Examples

Install an asdf-compatible plugin from its upstream repository

mise plugins install postgres https://github.com/smashedtoatoms/asdf-postgres.git

Use a local plugin repository at a tag you created

mise plugins install my-tool file:///path/to/mise-my-tool#v1.0.0

Install missing plugins that have configured shorthands

mise plugins install --all
<!-- generated reference navigation -->