mise lock gains an offline --check mode for CI, and --dry-run now shows what would actually change. New options let you limit mise to an allowlist of backends, choose musl or glibc builds for a single tool, pin PyPI packages to private uv indexes, and exclude git-ignored files from task sources. This release also fixes problems with lockfiles, Java build ordering, mise exec PATH order, Homebrew formulas, and shims.
Added
Lockfiles
-
mise lock --check. Checks thatmise.lockmatchesmise.tomlwithout writing anything or using the network. It fails with a list of everythingmise install --lockedwould reject: a version that isn't locked (for example, when an update bot bumpsmise.tomlbut not the lockfile), a platform entry with no URL, or a checksum that is missing or malformed. It also reports missing GitHub additional artifacts and missing or edited npm/PyPI dependency graphs. Platforms are chosen the same waymise lockchooses them.--jsonprints one object per platform entry. It can't be combined with--bump,--upgrade,--dry-run,--minimum-release-age,--sidecarsor atool@versionargument. #15768 (@jdx, @jmoreno11)$ mise lock --check mise ERROR ~/src/app/mise.lock would fail a locked install: - jq@1.6 is not in the lockfile - No lockfile checksum found for yq@4.44.1 on platform linux-x64 (...) (--locked mode) hint: run `mise lock` to update the lockfile
-
Provenance in
--checkoutput. Each platform entry now shows what it was verified with when it was locked:minisign,cosign,slsa,github-attestations,checksum only, ornone.--jsonadds a matchingprovenancefield. This information is for display only and doesn't change whether the check passes. #15769 (@jdx, @jmoreno11)
Backends
-
enable_backendsallowlist. Only the backends you list can resolve or install tools. Registry shorthands fall back to their next allowed backend, and an identifier that uses a backend you didn't list fails with an error that names the setting.disable_backendsstill applies on top of the allowlist. An empty list, the default, allows every backend. The setting checks each tool's configured backend, not tools that a backend runs itself (such as thenodeused bynpm:).mise install-intonow respects both settings. #15766 (@jdx, @jmoreno11)[settings] enable_backends = ["core", "aqua", "github"]
-
Per-tool
libcfor packslip and github tools. On Linux,libc = "musl"orlibc = "glibc"(alsognu) selects the build for one tool without changing the globallibcsetting. Once you set it, mise never falls back to the other libc. It errors if no matching build exists. The option is recorded in the lockfile, and you needmise install --forceto replace an existing install after changing it. It also works with the gitlab and forgejo backends. #15765 (@jdx, @jmoreno11)[tools] fnox = { version = "latest", libc = "musl" }
-
filter_binsforhttp:tools. Only the named executables are put onPATH, instead of the wholebin_pathdirectory. Thecursor-agentregistry entry now uses this, so its bundlednodeandrgno longer override your own. #15835 (@jdx) -
Private uv indexes for
pypi:packages. The newindexesandsourcestool options take individual packages (the tool or itswith/exposerequirements) from a named index, while everything else stays on the default index. They mirror uv'stool.uv.indexandtool.uv.sources, require uv and a dependency graph, and are recorded inmise.lock. Index URLs can't contain credentials. UseUV_INDEX_<NAME>_USERNAMEandUV_INDEX_<NAME>_PASSWORDinstead. #15840 (@jdx, @sisp)[tools."pypi:zensical"] version = "0.1.1" with = ["my-zensical-theme==1.2.3"] indexes = [{ name = "private", url = "<your private index URL>", explicit = true }] sources = { my-zensical-theme = { index = "private" } }
Tasks
-
!@gitignoreinsources. This entry removes git-ignored, untracked files from what the earlier entries matched, so build output ornode_modulesno longer makes a task stale. Like a!pattern, it is evaluated in order, so a later entry can add an ignored path back. Tracked files always count as sources. Only the repository's own.gitignorefiles and.git/info/excludeare used, not your global excludes file. #15796 (@jdx, @brodienguyen)[tasks.build] sources = ["pkg/**", "!@gitignore", "pkg/dist/**"]
-
Task completion offers one spelling per task. In a monorepo,
mise run <TAB>now suggests only the shortest name for each task. Typing:shows names qualified for the current config root, and//shows absolute paths. Every spelling still runs. #15832 (@jdx) -
Set one lock pool at a time.
mise settings set task.lock_pools.cpu 8andmise settings unset task.lock_pools.cpuchange a single entry without replacing the whole map. This works for any map setting, such asurl_replacements. Pool sizes can also come fromMISE_TASK_LOCK_POOLS, ascpu=8,gpu=1or a JSON object. #15794 (@jdx)
Bootstrap
-
Enable services without starting them. In
[bootstrap.services],state = "unchanged"only manages whether a unit starts at boot or login. mise never starts, stops, reloads or restarts it. This is useful for units such as a login manager. It works for system units and existing user units. It is rejected withmasked = trueand for user services that mise defines withcommandorbuiltin. #15759 (@jdx, @Vantesh)[bootstrap.services.greetd] state = "unchanged" enabled = true
-
[bootstrap.files]and[bootstrap.directories]now acceptpermissionsas another name formode, the same key[dotfiles]uses. Setting both is an error. #15849 (@jdx, @syhol)
Registry
- Added
cargo-nextest. #15854 (@jdx, @FalkWoldmann)
Changed
mise lock --dry-runreports real changes. It now resolves every tool and platform the same waymise lockdoes and compares the result with the lockfile on disk. Each entry is listed as a new entry, a version change, a new platform, changed fields (such aschecksum filled), a removal, orunchanged. Because of this, a dry run now makes network requests, may download artifacts to compute checksums, and fails wherevermise lockwould fail.--jsonoutput is unchanged. #15767 (@jdx, @jmoreno11)tool_config.lockedlockfiles are left alone after installs. When every config that writes a lockfile sets[tool_config] locked = true,mise install,mise exec,mise useand other install paths no longer add platforms, refresh entries or prune stale tools in that lockfile. Onlymise lock(andmise upgradefor newer versions) changes it. As a result, entries for removed tools now stay until you runmise lock. #15761 (@jdx, @jmoreno11)- The packages a plugin needs from the system (its
systemDependencies) are now installed with the Linux distribution's package manager (apk,apt,dnf,pacman,zypper) when it has a hint for them, instead of mise's built-in Homebrew. Libraries installed through Homebrew could not be found by the systempkg-configor compiler. #15839 (@jdx)
Fixed
- Java: with several builds of the same version installed (such as Temurin
+7and+101),mise ls, the runtime symlinks (latest,temurin-25, ...), lockfile selection andmise outdatednow treat the higher build number as newest. #15756 (@jdx) - When several
mise installprocesses ran at once, annpm:tool could fail because itsnode@ltsdependency was "not installed", even after another process had just installed it. #15757 (@jdx) mise install <tool>andmise x <tool>now fail with a clear message when the tool'sosoption excludes the current platform. Previously the error was about a missing release asset. #15826 (@jdx)- With
tool_config.locked, a tool limited to another OS no longer prints a "not in the lockfile" warning on every command. #15848 (@jdx) - When
mise lockrefuses an aqua SLSA provenance downgrade, the error now suggests settingslsa_signer_identityandslsa_signer_issuerin the tool options. #15827 (@jdx) mise x -- <cmd>runs the pinned tool's binary again, for example the pinned npm instead of Node's bundled npm, even when the inherited PATH already contains that tool's bin directory. #15838 (@jdx)- Inactive shims that fall back to a system binary no longer run
rustupchecks whenrustis configured. These checks could interfere withmise up. #15795 (@jdx) npm:installs with provenance verification work again on images without system CA certificates (such asnode:24-slim). The sigstore TUF fetch now uses mise's HTTP client, which falls back to the bundled roots. #15829 (@jdx)- Homebrew formulas: source builds from third-party taps that use
HOMEBREW_PREFIXand related constants now work. Files that a formula installs intobinorsbinare now executable. #15834, #15836 (@jdx) - Ruby previews such as
ruby = "4.1.0-preview1"now install from precompiled builds that are published as GitHub pre-releases, instead of failing or compiling from source. #15830 (@jdx) - Installing
rust@betaorrust@nightlywith aminimum_release_agecutoff now stops afterfetch_remote_versions_timeoutwith a clear error, instead of searching a slow dist server for minutes. #15847 (@jdx) mise pruneno longer marks the commit thatlatestcurrently points to as prunable for annpm:git source that tracks the default branch. If mise can't reach the remote, it keeps every install. #15837 (@jdx)mise ls --all-sourcesno longer hides a tool when a different tool is pinned to the same version. #15833 (@jdx)mise bootstrap --from <url> --updatenow pulls the source repository before loading its config. A source whose current commit has a broken config can now pick up its own fix. #15841 (@jdx, @Guria)
Documentation
- The task docs now say that a dependency requested with different arguments runs once for each set of arguments. #15855 (@jdx)
Full Changelog: v2026.11.9...v2026.11.10
💚 Sponsor mise
mise is built and maintained by @jdx, an open source developer at entire.io, the title sponsor of his open source work.
If mise saves you or your team time, please consider becoming an individual or company sponsor. Your support funds ongoing development and helps keep mise fast, free, and independent.