mise Updates & Release Notes

This release sharpens task handling around remote files, global config, and tool selectors, trims redundant work from shell activation, and fixes several bootstrap and platform-specific edge cases.

Note

This is the first published release since v2026.7.7 — versions 2026.7.8 through 2026.7.10 were tagged but never published due to a release pipeline issue. Their changes are included here; see Also in this release below.

Added

config: structured tool definitions now accept version, path, prefix, and ref selectors consistently in root [tools], inline task definitions, task templates, and file-task headers. Exactly one selector is required, and conflicting, missing, or non-string selectors now fail with a clear configuration error instead of silently defaulting or panicking. (#11069 by @risu729)

node = { version = "20" }
go = { prefix = "1.22" }
python = { ref = "main" }
shellcheck = { path = "/opt/shellcheck" }

Fixed

task: remote HTTP and Git-backed task files now have their #MISE headers parsed, so metadata like tools, description, and hide and inline TOML overrides are honored just like local file tasks. Git-backed task files are also made executable after cloning and on cache hits. (#11111 by @Marukome0743)

task: file tasks loaded from user-global or system configs are now correctly treated as global regardless of their include path, so custom global scripts appear under mise tasks --global, stay out of --local, and use the invoking project root. (#11106 by @risu729)

task: mise tasks info, extended listings, task help, and the MCP tasks resource now report every configuration source contributing to a task, with a new config_sources array in JSON output. Changing metadata in a TOML overlay now correctly invalidates the merged file task's cache. (#11098 by @risu729)

watch: mise --env <profile> watch now propagates the selected environment to the watched task, so profile-specific tasks resolve correctly on each rerun. (#11114 by @Marukome0743)

http: raw executables (such as PHP PHARs like Composer) installed via the HTTP backend are now created readable as well as executable (mode 0755 rather than 0711), fixing "Could not open input file" errors for interpreters run by non-owner users. (#11135 by @jdx)

java: mise latest java@<vendor> now prefers the base vendor variant over dashed specializations and sorts multi-feature vendor prefixes correctly. (#11109 by @roele)

config: reject conflicting tool selectors at parse time (see Added). (#11069 by @risu729)

bootstrap: systemd timers can now reference a managed service by its bare TOML key (e.g. unit = "dotfiles-maintain"), which resolves to dev.mise.<name>.service. Fully qualified names like nginx.service are still written verbatim. (#11128 by @jdx)

bootstrap: Homebrew casks that declare auto_updates are now accepted instead of failing with an unsupported-lifecycle error. (#11107 by @casparbreloh)

bootstrap: macOS defaults handling now treats a missing key or domain as unset rather than erroring during initial setup. (#11118 by @roele)

windows: mise uninstall now removes dangling runtime version pointer files (like 16 or latest) and cleans up the now-empty tool directory. (#11095 by @JamBalaya56562)

Performance

activate: the redundant initial prompt hook that ran immediately after activation is now skipped for bash, zsh, and fish when the session is unchanged, avoiding an extra mise process on shell startup. (#11130, #11131, #11134 by @jdx)

backend: archive extraction and macOS hdiutil/pkgutil waits now run via block_in_place, so parallel installs no longer starve download progress and other tasks of runtime threads. (#11136 by @jdx)

Registry

Allow the reviewed @nubjs/nub postinstall lifecycle script to run via the npm backend so upgrades keep the ~/.nub/shims hardlinks refreshed; default-deny behavior is preserved for all other packages. (#11126 by @risu729)

Documentation

environments: clarify mise directory variables (#11127 by @jdx)

Fix dead VersionFox and MCP documentation links (#11117 by @Bartok9)

Add an example showing how to alias multiple tools from one GitHub release (#11110 by @LukasKnuth)

Also in this release: v2026.7.8–v2026.7.10

Due to a release pipeline issue, versions 2026.7.8 through 2026.7.10 were tagged but never published. This is the first release since v2026.7.7, so it also ships everything below.

Added

bootstrap: package manager plugins — vfox Lua plugins can now act as system package managers, with a declarative [bootstrap.plugins] config and mise bootstrap plugins apply|status commands. Declared plugins install before built-in packages, then plugin-managed packages apply once host tools are available. (#11023, #11024 by @jdx)

bootstrap: new mise bootstrap repos update and mise bootstrap repos exec commands. Unpinned [bootstrap.repos] entries are intentionally never pulled by declarative apply; repos update gives an explicit fetch + fast-forward path (with dry-run and path filtering), and repos exec runs a command across configured checkouts. mise bootstrap --update now also updates repos. (#11022 by @jdx)

registry: opt-in floating registries — with registry_floating, mise fetches the latest released registry metadata (and the current aqua registry) instead of the release-pinned copies. Useful on distributions whose mise package lags behind releases while registry entries keep changing. (#10971 by @jdx)

backend: exact-version fast path — when a request is an exact semver version, the cargo, npm, go, gem, pipx, and dotnet backends now skip fetching the remote version list entirely and let the underlying installer validate it. This speeds up exact pins without a lockfile, first-time mise install [email protected], and mise x [email protected]. (#11013 by @Turbo87, #11070 by @jdx)

task: dependencies whose templated names render to an empty string are now skipped, so templates can conditionally disable a dependency. Empty templated dependency args are omitted as well. (#11057 by @risu729, #11055 by @jdx)

Fixed

http: mise now fails fast when the network is unavailable: DNS resolver failures are treated as non-retryable, a process-local circuit opens after hard DNS/connection failures, and remote-version lookups are capped at 3 seconds under prefer_offline. Shims, shell activation, and mise x make one bounded attempt instead of grinding through full retry schedules per endpoint. (#11066 by @jdx)

config: stricter, clearer configuration validation: env directive value aliases (#11062), env.mise directives (#11053), and the experimental monorepo root key (#11052) are deprecated, and non-string postinstall hooks are rejected at parse time (#11061) (all by @risu729)

hooks: hook definitions are validated more strictly — unknown table fields (#11047) and nested hook arrays (#11051) are rejected, and the spawned-scripts form is deprecated (#11043) (all by @risu729)

schema: a large batch of JSON schema corrections so editors validate real configs correctly: OCI copy entries (#11009), bootstrap shell activation (#11004) and bootstrap hooks (#11039), structured task tool options (#11021), required watch file patterns (#11040), plugin manifest fields (#11035), root hook definitions (#11041), integer types for integer settings (#11037), array-typed deps provider paths (#11064) (all by @risu729), and systemd timer/lifecycle options (#11050 by @jdx)

dry runs no longer cause side effects: task setup is skipped (#11015), install hooks are previewed instead of executed (#11010), and mise prune --dry-run preserves runtime symlinks (#11017) (all by @risu729)

bootstrap: Homebrew cask metadata is preserved (#11012) and macOS metadata files in cask artifacts are ignored (#11063); repo origins are compared transport-agnostically so git@ vs https:// remotes don't trigger spurious mismatches (#11034 by @jeremy); static systemd units no longer break bootstrap status (#11056 by @jdx)

backend: prerelease versions without a separator (like 1.2.3rc1) are detected correctly (#11032 by @jdx); cargo sparse-index version discovery is restored (#11011 by @Turbo87); go resolves direct package module prefixes (#11054 by @jdx)

install: false install env values are treated as removals (#11033 by @risu729)

lockfile: platform-specific tool option variants are preserved instead of being collapsed (#10999 by @jdx)

shell: hyphenated tool names work in shell integrations (#10961 by @risu729), and bash deactivate no longer errors on empty array expansions under set -u (#11026 by @jdx)

shim: recursion is prevented when the directory env is filtered (#10982 by @risu729)

task: file tasks resolve source files relative to the task directory (#11073 by @JamBalaya56562), and tasks generated from templates inherit the template's output setting (#11059 by @risu729)

launchd: bootout EIO for not-loaded agents is tolerated on macOS (#10965 by @hsbt)

nix: TZDIR is set so timezone tests pass in the sandbox build (#11019 by @coryzibell)

Performance

startup: ~2ms shaved off every invocation — config lookup no longer compiles ~200 glob patterns per startup (literal filenames are stat'd directly), and the clap command tree is built once instead of twice. mise version drops from 8.1ms to 6.6ms, hook-env from 10.9ms to 9.3ms. (#11025 by @jdx)

release: release binaries for linux-x64 and macos-arm64 are now built with profile-guided optimization, trained on a hermetic offline workload covering config load, toolset resolution, hook-env, env rendering, tasks, and exec — ~10% faster on hot paths and ~4% smaller binaries (#11031 by @jdx). macOS tarballs now target macOS 12 (#11027 by @jdx).

runtime: default tokio worker threads are capped at 16, avoiding oversized thread pools on many-core machines (#11029 by @jdx)

Refactor

tar extraction, inspection, and verification are consolidated onto jdx-tar, removing the system tar fallback and a duplicate tar implementation — consistent archive behavior across platforms (#11028 by @jdx)

Registry

add zmx (github:neurosnap/zmx) (#11006 by @offbyone)

docker-compose switched from the aqua to the github backend (#10823 by @konono)

eza switched from the asdf to the vfox backend (#11068 by @jdx)

Documentation

templates: clarify exec behavior in dry runs (#11018 by @risu729)

New Contributors

@Bartok9 made their first contribution in #11117

@LukasKnuth made their first contribution in #11110

@jeremy made their first contribution in #11034

@Turbo87 made their first contribution in #11011

@coryzibell made their first contribution in #11019

Full Changelog: v2026.7.7...v2026.7.11

💚 Sponsor mise

mise is maintained by @jdx, an open source developer for entire.io, the title sponsor of the jdx.dev open source tools. Development is funded by sponsors.

If mise saves you or your team time, please consider sponsoring at jdx.dev. Individual and company sponsorships keep mise fast, free, and independent.

Original source

This release extends dependency providers and systemd bootstrap to monorepo and timer-based workflows, and hardens GitHub OAuth token refreshes and cache clearing against concurrent mise processes.

Added

deps: experimental mise deps --monorepo runs dependency providers across every explicitly configured [monorepo].config_roots entry, aligned with mise install --monorepo. Provider IDs are qualified by config root (e.g. //apps/api:uv) so repeated provider names across subprojects no longer collide, and mise installs the union of tools declared across participating roots before running providers. Plain mise deps remains scoped to the current config root. (#10975 by @jdx)

monorepo_root = true

[monorepo]

config_roots = ["apps/", "packages/"]

mise deps --monorepo

mise deps --monorepo --only //apps/api:uv

bootstrap: manage systemd user timers alongside services via [bootstrap.linux.systemd.units]. Timer entries render to .timer units with scheduling (on_boot_sec, on_unit_active_sec, on_unit_inactive_sec, on_calendar), persistence, and timers.target linkage. Services gain optional directives including type, remain_after_exit, exec_stop, start/stop timeouts, no_new_privileges, and private_tmp. When a unit name switches between service and timer, the stale sibling unit is stopped, disabled, and removed on apply. (#10984 by @jdx)

Fixed

github: serialize OAuth token refreshes across mise processes. Single-use refresh tokens were only guarded by an in-process mutex, so parallel mise runs could burn the same token or overwrite the cache with stale data. The full read-refresh-write cycle now holds a filesystem lock, re-reads the cache after acquiring it, and writes atomically. Rejected refreshes now surface a sanitized error with reauthorization guidance instead of falling back silently to anonymous requests. (#10995 by @jdx)

cache: mise cache clear no longer fails with DirectoryNotEmpty when another mise process (e.g. hook-env) recreates cache files mid-removal. Removal now retries with bounded backoff and tolerates concurrently recreated entries, while permission and other errors still propagate. (#10993 by @jdx)

github: skip OS package and installer assets (.apk, .deb, .rpm, DMG/PKG, MSI/MSIX/AppX and sidecars) during automatic asset selection for the github:, gitlab:, and forgejo: backends, so releases containing only unsupported packages now report that no platform asset matches instead of installing an unusable file. Explicit asset_pattern and URL selection are unchanged. (#11001 by @risu729)

aqua: honor explicit false overrides for rosetta2, windows_arm_emulation, and no_asset, so a version or platform override can disable inherited emulation or asset flags instead of being treated as omitted. (#11002 by @risu729)

vfox: support short annotated-tag refs in plugin source URLs (e.g. a .git URL followed by #v1.0.0), resolving explicit refs against exact remote branch and tag namespaces so annotated tags no longer fail to check out. (#10998 by @junior-ricon)

task: render Tera templates in nested task-level tool option arrays and tables, and preserve their structure through resolution instead of dropping structured values. (#10960 by @risu729)

bootstrap: add Homebrew-compatible Array#second, #third, #fourth, and #fifth helpers to the cask shim, fixing casks (such as OrbStack) that reference version.csv.second. (#10992 by @casparbreloh)

status: status.show_env output now respects the status.truncate setting instead of always truncating. (#10983 by @ytjmt)

schema: add bootstrap.macos.launchd.agents.<name>.start_calendar_interval to the published schema (single schedule or array), so strict TOML validators and editors accept valid launchd calendar configurations. (#11008 by @risu729)

Registry

Add microsandbox (aqua:superradcompany/microsandbox) (#10985 by @joealden).

New Contributors

@junior-ricon made their first contribution in #10998

@ytjmt made their first contribution in #10983

@casparbreloh made their first contribution in #10992

Full Changelog: v2026.7.6...v2026.7.7

💚 Sponsor mise

mise is maintained by @jdx, an open source developer for entire.io, the title sponsor of the jdx.dev open source tools. Development is funded by sponsors.

If mise saves you or your team time, please consider sponsoring at jdx.dev. Individual and company sponsorships keep mise fast, free, and independent.

Original source

Added

task: per-task output style field, decoupled from verbosity, so styles like prefix and quietness combine freely #10885

sandbox: global [settings.sandbox] deny defaults (deny_all, deny_read, deny_write, deny_net, deny_env) #10940

bootstrap: Flatpak package support for [bootstrap.packages] on Linux #10951

oci: reproducible host path copy layers via mise oci build --copy HOST_PATH:IMAGE_PATH and [[oci.copy]] #10952

doctor: mise doctor now warns when a mise shim is shadowed by an earlier executable in PATH #10919

aqua: support for private github_content and github_archive packages via authenticated GitHub API endpoints #10915

task: task-level timeout values now render Tera templates #10959

http: http_download_timeout setting caps total download wall-clock time (default 30 minutes) #10920

registry: add git-town (aqua:git-town/git-town) #10935 and bundler (gem:bundler) #10939

Fixed

backend: reinstall rolling versions (e.g. nightly) when the installed content is outdated #10827

backend: align migrated backend resolution #10969

config: keep already-installed versions eligible when minimum_release_age is configured #10973

config: let user table-syntax tool options override registry defaults #10924

config: reload settings when config is reset so bootstrap phases use a consistent snapshot #10945

config: warn when a tool version uses an unsupported npm-style semver range #10916

config: add Tera contrib helpers #10970

task: preserve structured task-level tool options (arrays/tables such as os, depends, install_env) #10958

task: isolate usage_* variables per invocation so nested tasks don't inherit stale parser output #10963

task: invalidate auto freshness after a failed rerun #10953

task: respect configured includes directory when editing/adding file tasks #10955

s3: resolve cross-platform lockfile URLs for locked mode #10873

bootstrap: preserve symlinks when extracting DMGs and always detach on copy failure #10949

bootstrap: support localized brew casks (language, on_system_conditional) and reuse existing Ruby #10950

erlang: lock source install outcomes #10937

github: align SLSA provenance with the selected asset #10928

github: treat bin/rename_exe as install-time options #10925

npm: isolate version queries from project cwd #10927

cargo: own the cargo-binstall compile fallback #10926

registry: normalize backend platform selectors #10938

registry: rename the podman binary to podman-remote #10826

file: ignore malformed pax metadata during sparse detection #10978

copr: fix x86_64 builds (nasm/cmake for Fedora, PREBUILT_NASM for RHEL/EPEL) #10947 and add PIE flag for aws-lc probe #10974

toolset: preserve ref selector install identity #10942

Changed

cargo: disable cargo-quickinstall by default; opt back in with cargo.binstall_quickinstall = true #10923

registry: revert preferring aqua for codex #10922

Performance

aqua: skip public reachability probes for packages marked private #10914

Documentation

aqua: document local custom registries #10966

config: clarify sub-version arithmetic #10943

Breaking Changes

task: --quiet / quiet = true / MISE_QUIET=1 no longer collapse task output to un-prefixed interleave; they now preserve the resolved style. Use --output quiet (or -o interleave) for the old behavior #10885

task: usage_* variables are now invocation-local; workflows that injected them as implicit inputs must declare an input with env= instead #10963

💚 Sponsor mise

mise is maintained by @jdx, an open source developer for entire.io, the title sponsor of the jdx.dev open source tools. Development is funded by sponsors.

If mise saves you or your team time, please consider sponsoring at jdx.dev. Individual and company sponsorships keep mise fast, free, and independent.

Original source

This release makes config trust smarter across git worktrees and monorepos, and fixes npm-backed tools on npm 12.

Added

Trust is shared across git worktrees. Trust records are keyed by absolute path, so every new git worktree add checkout used to re-prompt for the same config. A config inside a linked worktree is now trusted automatically when the equivalent path in the repository's main checkout is trusted — trusting a repo once covers all of its worktrees. This is especially helpful for workflows that spin up many short-lived worktrees (e.g. AI-agent worktrees under .claude/worktrees/). Sharing flows one way, from main checkout to worktrees; an explicit --ignore still wins, and paranoid mode is excluded since its trust is tied to per-file content hashes. mise untrust inside a worktree now warns that the main checkout still trusts the config (#10890 by @jdx).

mise trust --all now trusts nested subdirectory configs. Previously --all only trusted config files in the current directory and its parents. It now also walks subdirectories and trusts each nested config root it finds, so a monorepo's nested configs can be trusted with one explicit command. The walk respects .gitignore, skips hidden directories, and skips node_modules, vendor, target, dist, and build so vendored configs are left untrusted. Each nested config gets its own trust record, so a config added later in a new subdirectory still prompts (#10889 by @jdx).

Fixed

npm: support npm 12 output. npm 12 wraps npm view --json responses in a single-item array, which broke version listing and latest-version detection for npm-backed tools. mise now normalizes both the legacy object shape and the new wrapped shape, and tolerates missing time metadata (#10888 by @jdx).

Changed

registry: the codex shorthand now prefers npm:@openai/codex over the aqua GitHub asset. The aqua asset for recent releases shipped only the main codex binary and omitted codex-code-mode-host, which broke tool calling; the npm package installs the full vendor bundle. Aqua remains available as an explicit or fallback backend (#10893 by @jdx).

Full Changelog: v2026.7.4...v2026.7.5

💚 Sponsor mise

mise is maintained by @jdx, an open source developer for entire.io, the title sponsor of the jdx.dev open source tools. Development is funded by sponsors.

If mise saves you or your team time, please consider sponsoring at jdx.dev. Individual and company sponsorships keep mise fast, free, and independent.

Original source