jdx/mise v2026.7.3

v2026.7.3: System dependency checks and cask lifecycle hooks

on GitHub

This release brings smarter builds for source-compiling tools, better Homebrew cask support, and a fix for lockfile entries losing their platform data during upgrades.

Added

• vfox: plugin-declared system dependencies. Source-compiling plugins (php, mysql, erlang, ...) often need build tools and libraries that previously showed up only as a failed ./configure twenty minutes into a build. vfox plugins can now declare these prerequisites in metadata.lua, and mise checks them before installing (#10848 by @jdx):

  PLUGIN.systemDependencies = {
      { bin = "bison", version = ">=3.0", packages = { brew = "bison", apt = "bison" } },
      { pkgconfig = "libxml-2.0", packages = { brew = "libxml2", apt = "libxml2-dev" } },
      { sharedlib = "libaio.so.1", packages = { apt = "libaio1" } },
  }

  Detection is the source of truth: a satisfied check passes regardless of how the capability was installed (Homebrew, apt, nix, from source), and the per-manager packages map is only used to offer installing the missing subset. A new system_deps setting controls behavior (prompt default, auto, warn, ignore); the check never fails an install. Missing deps also show up in mise doctor and mise bootstrap status. Declarations are inert on older mise versions and on upstream vfox.

• brew: cask lifecycle hooks. Homebrew cask installs now run supported preflight and postflight hooks via a mise-owned, sha256-verified Ruby shim (no brew delegation), which fixes wrapper-style casks like GIMP. Unsupported hook DSL fails with an explicit error (#10837 by @jdx).

• cli: terminal width override. In some CI environments width detection returns a bogus value and mise's table/list output (mise ls, mise registry, mise settings) renders oddly with no way to fix it. You can now override the detected width (#10862 by @JamBalaya56562):

  MISE_TERM_WIDTH=120 mise ls

  MISE_TERM_WIDTH takes precedence, with COLUMNS as a fallback. An explicit override is honored exactly (no 80-column floor); behavior is unchanged when neither is set.

Fixed

• upgrade: mise upgrade --bump can rewrite more lockfile entries than the tools it actually installs. Those rewritten entries were previously reduced to bare version/backend records, losing their cross-platform checksums and URLs. mise now re-locks stale entries that are missing platform metadata, so tools like ruff, biome, and typos keep their full lock data (#10752 by @zeitlinger).
• brew: casks whose binary is created by a pkg installer at an absolute path (e.g. karabiner-elements) now install correctly, staged through the caskroom as symlinks (#10841 by @jdx).
• vfox: traditional vfox plugin downloads now go into mise's per-tool download directory so they are cleaned up after install (#10840 by @risu729).
• brew: included the cask shim in the published crate, fixing a cargo publish verification failure (#10863 by @jdx).

Changed

• registry: switched a large batch of tools to the vfox backend: scala, groovy, mongodb, emsdk, teleport-community, teleport-ent, tinytex, mysql, elasticsearch, v, spring-boot, php, clojure, oci, jib, graalvm, gcc-arm-none-eabi, and tiny.

Documentation

• De-slopified the landing page copy and visuals (#10836 by @jdx).

Full Changelog: v2026.7.2...v2026.7.3

💚 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.