mise Release Notes

This release brings PowerShell users into the mise ecosystem with full tab completion support, making mise more accessible to Windows developers and PowerShell enthusiasts everywhere. The vfox backend also receives significant upgrades with rolling release support and a new semver Lua module for smarter version sorting.
File task handling gets a reliability boost with improved parsing, validation, and better error messages when unknown fields appear in task headers. Several schema and configuration fixes ensure your mise setup works more predictably across different scenarios.

Highlights

• PowerShell Completion Support: Tab completion now works in PowerShell sessions, bringing the same convenient autocomplete experience that bash, zsh, and fish users enjoy. See the shell completions documentation for setup instructions. (#7746) by @jdx
• Vfox Rolling Releases: The vfox backend now supports rolling releases with checksum tracking, enabling tools that publish frequent updates without traditional version numbers. A new semver Lua module also improves version sorting accuracy. (#7757, #7739) by @jdx
• Improved File Task Parsing: File tasks now have DRYer parsing logic and validate unknown fields in headers, catching configuration mistakes earlier with clearer error messages. (#7738, #7733) by @makp0

Bug Fixes

• Fixed schema missing the required string variant for environment variables (#7734) by @vadimpiven
• Fixed double forward slashes appearing in task list paths (#7744) by @collinstevens
• Fixed {{ version }} template variables being incorrectly processed during config load instead of being preserved for runtime evaluation (#7755) by @jdx

New Contributors

Welcome to our new contributors! 🎉

• @collinstevens made their first contribution in #7744
• @makp0 made their first contribution in #7738
• @vadimpiven made their first contribution in #7734

📦 Aqua Registry Updates

New Packages (2)

• F1bonacc1/process-compose
• kkinnear/zprint

Updated Packages (1)

• theryangeary/choose

This release brings significant improvements to dependency management, task execution, and backend flexibility, with a focus on reproducibility and performance.

The Conda backend now supports dependency locking for reproducible installations, ensuring your environments remain consistent across machines and time. The HTTP backend has been enhanced with JSON filtering and Tera templating for more flexible version extraction from web sources. Task execution sees improvements in monorepo support and performance, while several bug fixes address deadlocks and path resolution issues.

Highlights

• Reproducible Conda Environments - The Conda backend now supports dependency locking (#7708), allowing you to freeze exact package versions for reproducible installations. This ensures your conda environments remain identical across different machines and over time, crucial for scientific computing and data analysis workflows.
• Enhanced HTTP Backend - The HTTP backend gains powerful new features for version extraction (#7707, #7723). You can now use JSON filter syntax to extract versions from complex API responses, and Tera templating provides flexible string manipulation. This makes it easier to integrate tools that don't follow standard versioning patterns.
• Better Monorepo Task Support - Task execution in monorepos is now more flexible with explicit config root listing via [monorepo].config_roots (#7705). Task dependencies can now use environment variables (#7724), and path resolution for dependencies works correctly across monorepo boundaries (#7698, #7699).

Bug Fixes

• Fixed a deadlock that could occur when using venv/go backends during environment resolution (@stk0vrfl0w in #7696)
• Resolved hardcoded library paths in conda packages that prevented proper relocation (#7713)
• Tool stubs are now properly exempted from lockfile requirements (#7729)
• Python's ls-remote command now correctly sorts CPython versions at the end of the output (#7721)
• Remote task files are now resolved before display and validation commands (@yannrouillard in #7681)

Performance

• Task listing performance has been restored to previous levels by fixing a caching regression (#7716). Users with many tasks should notice significantly faster mise tasks commands.

Registry Updates

• Several tools have been migrated to more reliable backends:
  • Dotnet, Lua, Redis, and Postgres now use vfox backends by default for better cross-platform support
  • Kotlin and Crystal moved to GitHub backends for direct releases
  • SQLite and Make now use the conda backend
  • Meson uses pipx for Python-based installation
• Added Smithy support via aqua backend (#7661)
• Low-usage ASDF plugins have been removed to streamline the registry (#7701).

New Contributors

• Welcome to @yannrouillard and @stk0vrfl0w who made their first contributions to mise!

Highlights

• S3 Backend Support - You can now use Amazon S3 for private artifact storage, enabling secure distribution of internal tools and binaries. This is particularly useful for enterprise environments that need to host proprietary tools. See the S3 backend documentation for setup instructions. (@jdx, #7668)
• Enhanced Upgrade Command - The mise upgrade command now includes an --exclude flag to skip specific tools during bulk upgrades, and benefits from improved tab completion that shows only installed tools. This gives you more control when updating your development environment. Learn more in the upgrade command documentation. (@jdx, #7669, #7670)
• Hook and Environment Control - New --no-hooks and --no-env flags provide fine-grained control over mise's behavior, allowing you to skip hooks or environment variable loading when needed. This is helpful for debugging or when you need to run mise in isolation. (@aacebedo, #7560)

Bug Fixes

• npm circular dependencies - Fixed an issue where mise could get stuck in a loop when npm itself was listed as a dependency (@AprilNEA, #7644)
• GitHub authentication - Improved token handling to properly fall back to GITHUB_TOKEN when accessing github.com, resolving authentication issues for private repositories (@subdigital, #7667, #7673)
• Task inheritance - Tasks defined in parent directories are now properly inherited in monorepo setups, making it easier to share common tasks across projects (@chadxz, #7643)
• vfox backend upgrades - Fixed upgrading tools that use symlinked installations in the vfox backend (@TyceHerrman, #7012)
• Architecture validation - mise now properly rejects tool downloads when the architecture doesn't match your system, preventing installation of incompatible binaries (@jdx, #7672)
• Self-update efficiency - The self-update command now skips unnecessary operations when you're already on the latest version (@jdx, #7666)

Registry Updates

• Added support for new tools:
  • oh-my-posh - The popular cross-shell prompt theme engine (@scop, #7659)
  • bibtex-tidy - A BibTeX file formatter and cleaner (@3w36zj6, #7677)
• Also fixed the kscript configuration by removing an incorrect bin_path option (@risu729, #7693).

New Contributors

• Welcome to @AprilNEA, @opswole, @subdigital, and @aacebedo who made their first contributions to mise!

mise v2026.1.2

mise v2026.1.2 includes several important bug fixes and security improvements, particularly addressing version management edge cases and enhancing the tool's reliability across different scenarios.
This release also strengthens our GitHub workflow security to prevent potential code execution from untrusted sources, ensuring the safety of our development process and community contributions.

Bug Fixes

• Version Management Improvements

  • Fixed an issue where pre-release versions were incorrectly included when using latest with install_before (#7631) - thanks to @koh-sh
  • Enhanced version filtering to properly exclude test versions (e.g., 1.0.0-test) from stable version lists (#7647) - thanks to @belgio99
  • Resolved a year-boundary bug that caused mise self-update to fail when crossing into a new year (#7611)

• Backend and Asset Detection

  • Added support for .artifactbundle.zip files in asset selection, improving compatibility with certain tool distributions (#7657) - thanks to @swizzlr
  • Fixed HTTP backend to properly fallback to configuration when fetching tool options (#7655) - thanks to @roele

• Task System

  • Corrected tool inheritance behavior in tasks when using intermediate parent configurations (#7637) - thanks to @chadxz

• Security

  • Implemented safeguards in our GitHub workflows to prevent potential code execution from untrusted forks, enhancing the security of our development process

New Tools

• Added support for oha, a modern HTTP load testing tool (#7633) - thanks to @jylenhof

New Contributors

• Welcome to our first-time contributors!
• @swizzlr, @belgio99, @gmalinowski, @chadxz, @shina1024, @jonathanagustin, and @turbocrime

2026.1.1 - 2026-01-08

🚀 Features

• (config) add .miserc.toml for early initialization settings by @jdx in #7596
• allow to include tasks from git repositories by @vmaleze in #7582

🐛 Bug Fixes

• (config) mise use writes to lowest precedence config file by @jdx in #7598
• (python) sort miniconda versions by conda version instead of version string by @jdx in #7595
• Rust channel updates installing twice by @x9xhack in #7565
• use Bearer instead of token in authorization headers by @risu729 in #7593

📚 Documentation

• (url-replacements) document auth behaviour with url replacements by @risu729 in #7592
• correct spelling in walkthrough.md by @tomhoover in #7581

📦 Registry

• Revert "fix(registry): fix biome test to handle version prefix" by @risu729 in #7586
• use aqua backend for ty by @risu729 in #7539
• update opencode's org from sst to anomalyco by @graelo in #7594

New Contributors

• @graelo made their first contribution in #7594
• @tomhoover made their first contribution in #7581
• @vmaleze made their first contribution in #7582

2026.1.0 - 2026-01-07

🚀 Features

• (hooks) add tool context env vars to postinstall hooks by @jdx in #7521
• (sops) support standard SOPS environment variables by @yordis in #7461
• (tasks) Add disable_spec_from_run_scripts setting by @iamkroot in #7471
• (tasks) Add task_show_full_cmd setting by @iamkroot in #7344
• (tasks) enable naked task completions and ::: separator by @jdx in #7524
• add Forgejo backend by @roele in #7469
• override node bundled npm by specified version of npm by @risu729 in #7559

🐛 Bug Fixes

• (aqua) fix tree-sitter bin path regression by @risu729 in #7535
• (ci) exclude subcrate tags from release workflow by @jdx in #7517
• (e2e) remove hardcoded year from version check by @jdx in #7584
• (github) asset matcher does not handle mixed archive/binary assets properly by @roele in #7566
• (github) prioritize .zip on windows by @risu729 in #7568
• (github) prefer .zip over non-archive extensions on linux by @risu729 in #7587
• (npm) always use hoisted installs of bun by @sushichan044 in #7542
• (npm) suppress NPM_CONFIG_UPDATE_NOTIFIER by @risu729 in #7556
• (registry) fix biome test to handle version prefix by @jdx in #7585
• (tasks) load monorepo task dirs without config by @matixlol in #7478
• force reshim when windows_shim_mode is hardlink by @roele in #7537
• simple .tar files are not extracted properly by @roele in #7567
• quiet kerl update output by @iloveitaly in #7467

📚 Documentation

• (registry) remove ubi backend from preferred backends list by @risu729 in #7555
• (tasks) remove advanced usage specs sections from toml-tasks.md by @risu729 in #7538
• fix invalid config section [aliases] by @muzimuzhi in #7518
• Fix path to GitLab backend source by @henrebotha in #7529
• Fix path to GitLab backend source by @henrebotha in #7531
• update mise --version output by @muzimuzhi in #7530

🧪 Testing

• (win) use pester in backend tests by @risu729 in #7536
• update e2e tests to use [tool_alias] instead of [alias] by @muzimuzhi in #7520

📦️ Dependency Updates

• update alpine:edge docker digest to ea71a03 by @renovate[bot] in #7545
• update docker/setup-buildx-action digest to 8d2750c by @renovate[bot] in #7546
• update ghcr.io/jdx/mise:copr docker digest to 23f4277 by @renovate[bot] in #7548
• update ghcr.io/jdx/mise:alpine docker digest to 0adc211 by @renovate[bot] in #7547
• lock file maintenance by @renovate[bot] in #7211
• lock file maintenance by @renovate[bot] in #7572
• replace dependency @tsconfig/node18 with @tsconfig/node20 by @renovate[bot] in #7543
• replace dependency @tsconfig/node20 with @tsconfig/node22 by @renovate[bot] in #7544

📦 Registry

• add zarf by @joonas in #7525
• update aws-vault to maintained fork by @h3y6e in #7527
• fix claude backend http for windows-x64 by @granstrand in #7540
• add sqlc by @phm07 in #7570
• use spm backend for swift-package-list by @risu729 in #7569
• add npm (npm:npm) by @risu729 in #7557
• add github backend for tmux by @ll-nick in #7472

Chore

• (release) update Changelog for v2025.12.13 by @muzimuzhi in #7522

New Contributors

• @ll-nick made their first contribution in #7472
• @sushichan044 made their first contribution in #7542
• @phm07 made their first contribution in #7570
• @granstrand made their first contribution in #7540
• @h3y6e made their first contribution in #7527
• @matixlol made their first contribution in #7478