mise bootstrap can now manage MacPorts ports and update mise itself before tools. GitHub, GitLab and Forgejo tools can follow the most recently published release, and Homebrew tap formulae can pour bottles and download from private GitHub releases. This release also fixes http: checksum verification, shims for path: versions, mise unuse -g with split global configs, Windows Server Core startup, and several task, bootstrap and Java issues.
Added
Bootstrap
-
MacPorts package manager. On macOS, you can declare ports in
[bootstrap.packages]with themacports:prefix and install or remove them withmise bootstrap. mise findsportonPATHor at/opt/local/bin/port, and runs installs, upgrades and removals through the existing sudo handling. It never runsport selfupdateand does not install MacPorts itself. Version pins are checked against the active port but can't be installed. Unprefixed keys don't use MacPorts unless you add it tosystem_packages.prefer. #15862 (@jdx, @snuxoll)[bootstrap.packages] "macports:ripgrep" = "latest" "macports:bc" = { state = "absent" }
-
Update mise before tools. Both options are opt-in and the defaults are unchanged. #15897 (@jdx)
mise bootstrap --self-updateupdates mise, then runs the same bootstrap again with the new binary. If the update fails, nothing is applied. The flag is ignored with--dry-runand for subcommands.tool_update.self_update_first = truemakes each automatic tool update pass check for and install a newer mise first. This requiresself_update.auto. If the mise update fails, tools are skipped until the next interval andmise doctorshows the error. It is skipped in CI, in offline modes and for mise installed by a package manager.
[settings] self_update.auto = true tool_update.self_update_first = true
Homebrew taps (system packages)
- Formulae from third-party taps now pour the bottles the tap declares in its
bottle doblock instead of always building from source. Only a bottle for the exact host tag orallis used. Formulae withpost_installorpour_bottle?restrictions still build from source. #15893 (@jdx) - Tap formulae that use a custom download strategy to fetch GitHub release assets, usually from a private repo, can now be installed. mise doesn't run the Ruby strategy. It downloads the asset through the GitHub API with your configured GitHub credentials (
MISE_GITHUB_TOKEN,github.credential_command, and so on) and checks its sha256. This works for both source builds and bottles. Other custom strategies are still rejected. #15898 (@jdx) - Source builds now support
virtualenv_install_with_resourcesfrom Homebrew'sLanguage::Python::Virtualenv. mise verifies each resource against its sha256 and installs it into a venv in the keg'slibexec, then links the formula's console scripts intobin. #15896 (@jdx)
Tools
-
version_order = "published_at"makeslatestfollow the release that was published most recently, even when its version number is lower. This is useful for repos that ship both stable and prerelease builds, where GitHub doesn't always list releases in publication order.mise latest,mise upgradeandauto_updateall use this order. It works with github, gitlab and forgejo tools. #15860 (@jdx)[tools] "github:openai/codex" = { version = "latest", prerelease = true, version_prefix = "rust-v", version_order = "published_at" }
-
exclude-newer = falseon a PyPI index. It turns off theminimum_release_agecutoff for packages from that index only. Use it for indexes that don't serve upload times, such as GitLab's PEP 503 index. Previously, uv filtered out every release from those indexes.falseis the only accepted value. #15885 (@jdx)indexes = [{ name = "private", url = "<index-url>", explicit = true, exclude-newer = false }]
-
New registry shorthand
rtk-proxyfor the proxy daemon that ships inrtk-ai/rtkreleases. Note that the proxy is licensed separately (BUSL-1.1). #15915 (@jdx)
Tasks
-
if_poolon task locks. Withif_pool = true, a task takes the lock only on machines whosetask.lock_poolsdeclares that name. On other machines it runs without the lock. It also works withcount. #15917 (@jdx)[tasks.benchmarks] lock = { name = "xcode", if_pool = true }
Dotfiles and GitHub tokens
history.allow_secret_values. This global-only setting (alsoMISE_HISTORY_ALLOW_SECRET_VALUES) lists specific values that the dotfile history secret scan ignores, such as"ctx7_api_key". A listed placeholder no longer blocks history sync. The same key with another value, or a real token on the same line, is still refused, and the rest of the scan stays on. #15864 (@jdx)- When
ghkeeps its token in the system keyring,mise token githubnow prints a hint on stderr that suggests acredential_commandusinggh auth token. Stdout and--rawoutput are unchanged. #15868 (@jdx, @FalkWoldmann)
Fixed
Installs and tools
http:tools withchecksum_urlnow verify the download against the published checksum when installing, and record that checksum inmise.lock. Previously the checksum was used only bymise lock, so a wrong download could install without an error. A mismatch or an unresolvable checksum now fails the install. An explicitchecksumor lockfile entry still takes precedence. #15908 (@jdx)mise reshimnow creates shims for tools whose version ispath:.... Previously a shim-based shell reportedcommand not foundeven thoughmise whichfound the tool. #15866 (@jdx)- Archives that contain absolute symlinks to files inside the same archive (for example osquery's
/opt/...links) install again. mise rewrites those links as relative links. Links to paths outside the archive are still refused. #15857 (@jdx, @bendrucker) - A non-root
mise installno longer fails withfailed to rebuild runtime symlinkswhen a tool is installed only in another user's read-only shared or system installs directory. #15858 (@jdx) gem:tools keep working after a Ruby patch upgrade when one of their dependencies was installed only in the old Ruby's gem directory. mise now copies those dependencies into the tool's own install. #15907 (@jdx)mise upgradenow detects new commits for npm git sources that track HEAD, so--pruneremoves the old commit. Previously, commit SHAs were compared as version strings. #15905 (@jdx).sdkmanrcTemurin versions with a fourth segment now install. Hotfix versions such as26.0.2.1+1-temand regular releases such as21.0.13.0+9-temnow map to the matching catalog builds. #15877, #15906 (@jdx)mise oci pushnow rewrites both lines of uv's long-path launcher inpypi:tool layers. Previously, images built in CI could fail with.../.mise-uv/.venv/bin/python: not found. Layers cached from earlier pushes are not reused. #15879 (@jdx)
Windows
mise.exeandmise-shim.exenow link the C runtime statically, so they start on Windows Server Core images without the VC++ redistributable. Previously they exited silently with0xC0000135. #15852 (@jdx)mise activate bashin Git Bash now produces validPATHentries when mise was installed with Scoop and runs through the Scoop shim. #15863 (@jdx)
Config and CLI
mise unuse -gnow removes a tool from every global config file that declares it, including files written throughsettings.write_targets.tools. Previously it edited onlyconfig.tomland did nothing for tools declared elsewhere.unusealso warns when none of the given tools are declared, instead of exiting silently. #15884 (@jdx, @theblop)enable_toolsanddisable_tools(andMISE_ENABLE_TOOLS/MISE_DISABLE_TOOLS) now accept the same legacy names as[tools], such asnodejs,golang,dotnet-coreandcore:prefixes. #15880 (@jdx, @mfroembgen)- Commands such as
mise installno longer warn about ignored global-only settings in tracked configs from other folders, because those settings never apply to the current folder. The warning still appears inside the folder that owns the config. #15919 (@jdx, @owpac) - Tera deprecation warnings now name the config file that uses the deprecated helper. #15927 (@jdx, @Thomascountz)
mise doctorno longer crashes when an asdf or vfox plugin repo has no commits. It shows the plugin as(unknown), and plugin install or update now reports an error in this case instead of panicking. #15850 (@jdx, @xanathar)
Tasks and deps
- A bare
dependsname in a monorepo task now falls back to a global task when the project has no task with that name.depends = ["::name"]now gives a clearer error. #15851 (@jdx) - Tasks with
cache.command_inputsno longer fail withcommand output pipes did not close within 10son heavily loaded machines. #15916 (@jdx, @brodienguyen) - With
rustconfigured,mise runnow checks each toolchain's rustup state once per run instead of twice. #15878 (@jdx) mise depsnow marks theuvprovider stale when a workspace member'spyproject.tomlchanges. It also marks thepnpmprovider stale whenpnpm-workspace.yamlor a member'spackage.jsonchanges. An explicitsourceslist still replaces the defaults. #15918, #15926 (@jdx)
Bootstrap and system packages
mise bootstrapnow runs a monorepo root'sbootstraptask (//:bootstrap). Previously it was skipped. #15853 (@jdx)- If no remote environment is set with
mise_envor--remote-env,mise bootstrap remotenow lets the host's miserc choose its config environments. Previously it forced an emptyMISE_ENV. An explicitmise_env = []still selects none. #15865 (@jdx, @Guria) mise bootstrap --dry-runnow previews dotfiles declared by a conf.d config that amode = "template"dotfile renders. The preview only renders templates that don't need commands, environment variables, file reads or secrets. #15861 (@jdx)- A cask that can't be resolved, such as one from a tap that returns 404, is now reported as
erroron its own line. Other packages are still checked and applied, and the command exits non-zero at the end. Previously the whole status check or bootstrap stopped. #15909 (@jdx) mise bootstrap packages prunenow keeps the runtime dependencies (including indirect ones) of the formulae you declared, so it no longer removes libraries they link against. #15890 (@jdx)- Casks from third-party taps that use
command_wrappernow install. Previously they failed with an unsupported DSL error, which also broke the cask check inmise doctor. #15891 (@jdx) - mise can now infer the version of a tap formula whose archive name has no dots, such as
LUFA-210130.tar.gzor a date. #15892 (@jdx) - When a
[dotfiles]merge key has no/<id>segment, the error now says so and suggests the corrected key. #15859 (@jdx)
Documentation
- The guide for authors of settings plugins moved into the Writing plugins docs. #15846 (@jdx, @syhol)
Full Changelog: v2026.11.10...v2026.11.11
💚 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.