Skip to content

mise deps

  • Usage: mise deps [FLAGS] [PROVIDER] [SUBCOMMAND]
  • Aliases: dep, prepare
  • Effect: modifies state
  • Source code: src/cli/deps/mod.rs

[experimental] Manage project dependencies

With no subcommand, runs dependency installation for the current project, the same as mise deps install. Providers detect their inputs and installed outputs to decide whether work is needed; use --explain PROVIDER to inspect that decision.

Providers with auto = true run before mise exec and mise run unless --no-deps is passed. These install project dependencies, such as node_modules, separately from versioned tools managed by mise install.

Arguments

  • [PROVIDER] — Provider to operate on (runs only this provider, or use with --explain)

Flags

  • --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 Variable: MISE_MONOREPO

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

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

  • -h --help — Print help

Examples

mise deps                    # Install all project dependencies
mise deps install            # Same as bare `mise deps`
mise deps install --force    # Force reinstall even if fresh
mise deps install --dry-run  # Show what would run
mise deps --monorepo         # Install deps from explicit monorepo config roots
mise deps add npm:react      # Add a dependency
mise deps add -D npm:vitest  # Add a dev dependency
mise deps remove npm:lodash  # Remove a dependency

Subcommands

Configuration:

toml
# Built-in npm provider (auto-detects lockfile)
[deps.npm]
auto = true              # Auto-run before mise x/run

# Custom provider
[deps.codegen]
auto = true
sources = ["schema/*.graphql"]
outputs = ["src/generated/"]
run = "npm run codegen"

# To disable npm instead, add `disable = ["npm"]` under [deps].
MIT LicenseCopyright © 2026jdx.dev