jdx/mise v2026.3.14

v2026.3.14: GitHub token management, macOS shim fix, and Python precompiled flavor fix

on GitHub

This release introduces a new mise github token command and expanded GitHub token resolution (including a config file and git credential helper support), fixes a shim detection regression that caused hangs on macOS, and corrects Python precompiled flavor handling for freethreaded builds.

Highlights

• New mise github token command and github_tokens.toml config file for flexible, per-host GitHub token management
• Reverted shim directory check that caused startup hangs on macOS
• Python lockfile generation now respects precompiled_flavor when filtering out freethreaded builds

Added

• mise github token command and expanded token resolution -- Adds github_tokens.toml (~/.config/mise/github_tokens.toml) for storing per-host GitHub tokens that don't interfere with the gh CLI's hosts.yml. Also adds opt-in git credential fill integration as a last-resort fallback for environments where tokens live in system keyrings (macOS Keychain, Windows Credential Manager, devcontainers). The new mise github token [--unmask] [HOST] command shows which token mise would use and where it came from, making it easy to debug authentication issues. Enable git credential support with github.use_git_credentials = true in settings. #8742 by @jdx

  Updated token priority:

  #	Source
  1	MISE_GITHUB_ENTERPRISE_TOKEN env var (non-github.com only)
  2	MISE_GITHUB_TOKEN / GITHUB_API_TOKEN / GITHUB_TOKEN env vars
  3	github_tokens.toml (per-host) -- new
  4	gh CLI token (from hosts.yml)
  5	git credential fill (opt-in) -- new

• Registry: tart -- Added tart to the registry. Tart provides macOS and Linux VMs on Apple Silicon using Apple's Virtualization.framework. Install with mise install tart. #8727 by @mnm364

Fixed

• Shim detection reverted to fix macOS hangs -- A recent change (cfcb555) switched shim detection from checking the binary name to checking if argv[0] exists in the shims directory. This caused mise to hang on startup for some users because the filesystem check could block on slow or network filesystems, and could also falsely detect mise itself as a shim. The simpler binary-name-based check has been restored. e1b8ca4 by @jdx

• Python precompiled flavor now correctly excludes freethreaded builds -- When any precompiled_flavor was specified (e.g. install_only_stripped), the freethreaded build exclusion was bypassed, causing mise lock to sometimes pick the freethreaded build incorrectly. Freethreaded builds are now only included when the requested flavor specifically includes "freethreaded". #8745 by @risu729

• cargo install mise docs now use --locked -- The Cargo install command in the documentation has been updated to cargo install --locked mise, preventing build failures from dependency version mismatches. #8731 by @rtharston

New Contributors

• @rtharston made their first contribution in #8731

Full Changelog: v2026.3.13...v2026.3.14