uv 0.10.6 does not set path on macOS

[ashemedai]

On a WSL Debian Linux I updated uv from 0.10.5 to 0.10.6 (latest) without any issue.

On macOS however, it seems the path no longer gets set.

Output of mise doctor after mise use uv@0.10.5:

version: 2026.2.21 macos-arm64 (2026-02-26)
activated: yes
shims_on_path: no
self_update_available: no

build_info:
  Target: aarch64-apple-darwin
  Features: DEFAULT, NATIVE_TLS, SELF_UPDATE
  Built: Thu, 26 Feb 2026 10:17:17 +0000
  Rust Version: rustc 1.93.1 (01f6ddf75 2026-02-11) (Homebrew)
  Profile: release

shell:
  /opt/homebrew/bin/zsh
  zsh 5.9 (arm-apple-darwin24.0.0)

aqua:
  baked in registry tools: 2237

dirs:
  cache: ~/Library/Caches/mise
  config: ~/.config/mise
  data: ~/.local/share/mise
  shims: ~/.local/share/mise/shims
  state: ~/.local/state/mise

config_files:
  ~/.config/mise/config.toml

ignored_config_files: (none)

backends:
  aqua
  asdf
  cargo
  conda
  core
  dotnet
  forgejo
  gem
  github
  gitlab
  go
  npm
  pipx
  spm
  http
  s3
  ubi
  vfox

plugins:

toolset:
  aqua:BurntSushi/ripgrep@15.1.0
  aqua:JohnnyMorganz/StyLua@2.3.1
  aqua:LuaLS/lua-language-server@3.17.1
  aqua:astral-sh/ruff@0.15.4
  aqua:astral-sh/uv@0.10.5
  aqua:dandavison/delta@0.18.2
  aqua:editorconfig-checker/editorconfig-checker@3.6.1
  aqua:errata-ai/vale@3.13.1
  aqua:google/yamlfmt@0.21.0
  aqua:jqlang/jq@1.8.1
  aqua:mvdan/gofumpt@0.9.2
  aqua:rust-lang/rust-analyzer@2026-02-23
  aqua:sharkdp/fd@10.3.0
  aqua:tamasfe/taplo@0.10.0
  aqua:tree-sitter/tree-sitter@0.26.6
  core:go@1.26.0
  core:node@24.14.0
  go:github.com/docker/docker-language-server/cmd/docker-language-server@0.20.1
  go:github.com/hashicorp/terraform-ls@0.38.4
  go:golang.org/x/tools/gopls@0.21.1
  go:golang.org/x/vuln/cmd/govulncheck@1.1.4
  npm:awk-language-server@0.10.6
  npm:markdownlint@0.40.0
  npm:neovim@5.4.0
  npm:pyright@1.1.408
  npm:typescript-language-server@5.1.3
  npm:typescript@5.9.3
  npm:vscode-langservers-extracted@4.10.0
  npm:yaml-language-server@1.21.0

path:
  ~/.local/share/mise/installs/delta/0.18.2/delta-0.18.2-aarch64-apple-darwin
  ~/.local/share/mise/installs/editorconfig-checker/3.6.1/bin
  ~/.local/share/mise/installs/fd/10.3.0/fd-v10.3.0-aarch64-apple-darwin
  ~/.local/share/mise/installs/go/1.26.0/bin
  ~/.local/share/mise/installs/go-github-com-docker-docker-language-server-cmd-docker-language-server/0.20.1/bin
  ~/.local/share/mise/installs/go-github-com-hashicorp-terraform-ls/0.38.4/bin
  ~/.local/share/mise/installs/go-golang-org-x-tools-gopls/0.21.1/bin
  ~/.local/share/mise/installs/go-golang-org-x-vuln-cmd-govulncheck/1.1.4/bin
  ~/.local/share/mise/installs/gofumpt/0.9.2
  ~/.local/share/mise/installs/jq/1.8.1
  ~/.local/share/mise/installs/lua-language-server/3.17.1/bin
  ~/.local/share/mise/installs/node/24.14.0/bin
  ~/.local/share/mise/installs/npm-awk-language-server/0.10.6/bin
  ~/.local/share/mise/installs/npm-markdownlint/0.40.0/bin
  ~/.local/share/mise/installs/npm-neovim/5.4.0/bin
  ~/.local/share/mise/installs/npm-pyright/1.1.408/bin
  ~/.local/share/mise/installs/npm-typescript/5.9.3/bin
  ~/.local/share/mise/installs/npm-typescript-language-server/5.1.3/bin
  ~/.local/share/mise/installs/npm-vscode-langservers-extracted/4.10.0/bin
  ~/.local/share/mise/installs/npm-yaml-language-server/1.21.0/bin
  ~/.local/share/mise/installs/ripgrep/15.1.0/ripgrep-15.1.0-aarch64-apple-darwin
  ~/.local/share/mise/installs/rust-analyzer/2026-02-23
  ~/.local/share/mise/installs/stylua/2.3.1
  ~/.local/share/mise/installs/taplo/0.10.0
  ~/.local/share/mise/installs/tree-sitter/0.26.6
  ~/.local/share/mise/installs/uv/0.10.5/uv-aarch64-apple-darwin
  ~/.local/share/mise/installs/vale/3.13.1
  ~/.local/share/mise/installs/yamlfmt/0.21.0
  ~/.local/google-cloud-sdk/bin
  ~/bin
  /opt/homebrew/bin
  /usr/local/bin
  /usr/bin
  /usr/sbin
  /bin
  /sbin
  ~/.cargo/bin
  ~/.local/bin
  /Applications/Visual Studio Code.app/Contents/Resources/app/bin
  /Applications/Ghostty.app/Contents/MacOS

env_vars:
  MISE_SHELL=zsh

settings:

No problems found

Now with mise use uv@0.10.6:

version: 2026.2.21 macos-arm64 (2026-02-26)
activated: yes
shims_on_path: no
self_update_available: no

build_info:
  Target: aarch64-apple-darwin
  Features: DEFAULT, NATIVE_TLS, SELF_UPDATE
  Built: Thu, 26 Feb 2026 10:17:17 +0000
  Rust Version: rustc 1.93.1 (01f6ddf75 2026-02-11) (Homebrew)
  Profile: release

shell:
  /opt/homebrew/bin/zsh
  zsh 5.9 (arm-apple-darwin24.0.0)

aqua:
  baked in registry tools: 2237

dirs:
  cache: ~/Library/Caches/mise
  config: ~/.config/mise
  data: ~/.local/share/mise
  shims: ~/.local/share/mise/shims
  state: ~/.local/state/mise

config_files:
  ~/.config/mise/config.toml

ignored_config_files: (none)

backends:
  aqua
  asdf
  cargo
  conda
  core
  dotnet
  forgejo
  gem
  github
  gitlab
  go
  npm
  pipx
  spm
  http
  s3
  ubi
  vfox

plugins:

toolset:
  aqua:BurntSushi/ripgrep@15.1.0
  aqua:JohnnyMorganz/StyLua@2.3.1
  aqua:LuaLS/lua-language-server@3.17.1
  aqua:astral-sh/ruff@0.15.4
  aqua:astral-sh/uv@0.10.6
  aqua:dandavison/delta@0.18.2
  aqua:editorconfig-checker/editorconfig-checker@3.6.1
  aqua:errata-ai/vale@3.13.1
  aqua:google/yamlfmt@0.21.0
  aqua:jqlang/jq@1.8.1
  aqua:mvdan/gofumpt@0.9.2
  aqua:rust-lang/rust-analyzer@2026-02-23
  aqua:sharkdp/fd@10.3.0
  aqua:tamasfe/taplo@0.10.0
  aqua:tree-sitter/tree-sitter@0.26.6
  core:go@1.26.0
  core:node@24.14.0
  go:github.com/docker/docker-language-server/cmd/docker-language-server@0.20.1
  go:github.com/hashicorp/terraform-ls@0.38.4
  go:golang.org/x/tools/gopls@0.21.1
  go:golang.org/x/vuln/cmd/govulncheck@1.1.4
  npm:awk-language-server@0.10.6
  npm:markdownlint@0.40.0
  npm:neovim@5.4.0
  npm:pyright@1.1.408
  npm:typescript-language-server@5.1.3
  npm:typescript@5.9.3
  npm:vscode-langservers-extracted@4.10.0
  npm:yaml-language-server@1.21.0

path:
  ~/.local/share/mise/installs/delta/0.18.2/delta-0.18.2-aarch64-apple-darwin
  ~/.local/share/mise/installs/editorconfig-checker/3.6.1/bin
  ~/.local/share/mise/installs/fd/10.3.0/fd-v10.3.0-aarch64-apple-darwin
  ~/.local/share/mise/installs/go/1.26.0/bin
  ~/.local/share/mise/installs/go-github-com-docker-docker-language-server-cmd-docker-language-server/0.20.1/bin
  ~/.local/share/mise/installs/go-github-com-hashicorp-terraform-ls/0.38.4/bin
  ~/.local/share/mise/installs/go-golang-org-x-tools-gopls/0.21.1/bin
  ~/.local/share/mise/installs/go-golang-org-x-vuln-cmd-govulncheck/1.1.4/bin
  ~/.local/share/mise/installs/gofumpt/0.9.2
  ~/.local/share/mise/installs/jq/1.8.1
  ~/.local/share/mise/installs/lua-language-server/3.17.1/bin
  ~/.local/share/mise/installs/node/24.14.0/bin
  ~/.local/share/mise/installs/npm-awk-language-server/0.10.6/bin
  ~/.local/share/mise/installs/npm-markdownlint/0.40.0/bin
  ~/.local/share/mise/installs/npm-neovim/5.4.0/bin
  ~/.local/share/mise/installs/npm-pyright/1.1.408/bin
  ~/.local/share/mise/installs/npm-typescript/5.9.3/bin
  ~/.local/share/mise/installs/npm-typescript-language-server/5.1.3/bin
  ~/.local/share/mise/installs/npm-vscode-langservers-extracted/4.10.0/bin
  ~/.local/share/mise/installs/npm-yaml-language-server/1.21.0/bin
  ~/.local/share/mise/installs/ripgrep/15.1.0/ripgrep-15.1.0-aarch64-apple-darwin
  ~/.local/share/mise/installs/rust-analyzer/2026-02-23
  ~/.local/share/mise/installs/stylua/2.3.1
  ~/.local/share/mise/installs/taplo/0.10.0
  ~/.local/share/mise/installs/tree-sitter/0.26.6
  ~/.local/share/mise/installs/vale/3.13.1
  ~/.local/share/mise/installs/yamlfmt/0.21.0
  ~/.local/google-cloud-sdk/bin
  ~/bin
  /opt/homebrew/bin
  /usr/local/bin
  /usr/bin
  /usr/sbin
  /bin
  /sbin
  ~/.cargo/bin
  ~/.local/bin
  /Applications/Visual Studio Code.app/Contents/Resources/app/bin
  /Applications/Ghostty.app/Contents/MacOS

env_vars:
  MISE_SHELL=zsh

settings:

No problems found

Notice the sudden disappearance of uv from the path section. This only happens on macOS and only for 0.10.6/latest of uv. Linux (Debian) is working fine.

Looking at the recent Aqua update for this version does not seem to point out anything on that side that would explain this discrepancy to me.

[pratikrath126]

Interesting! The key clue is shims_on_path: no and the absence of the uv 0.10.6 binary in your PATH. A few things to check:

1. Verify that uv 0.10.6 actually installed correctly:
   ls ~/.local/share/mise/installs/uv/0.10.6/ should show the binary (often named uv-aarch64-apple-darwin or uv). If not, reinstall: mise uninstall uv@0.10.6 && mise install uv@0.10.6.

2. Mise shims not on PATH: This is required. Ensure your shell has eval "$(mise activate zsh)" in ~/.zshrc (or appropriate hook), then restart the shell or source the file. After that, mise doctor should show shims_on_path: yes.

3. Asset name change: The aqua package for uv may have changed the binary name in 0.10.6 (e.g., from uv-aarch64-apple-darwin to uv). If the install exists but the shim expects the old name, the shim fails. Check the installed binary name and, if needed, create a symlink to match previous pattern or report to aqua-registry.

If those do not help, try running the binary directly from the install dir to confirm it works, then open an issue with details.

[ashemedai]

The weird thing is that the Linux installation also has shims-on_path: no.

On macOS:

# mise is getting activated and PATH filled accordingly
% grep -n mise ~/.zshrc
186:eval "$(mise activate zsh)"
% mise use uv@0.10.5
uv@0.10.5
mise ~/.config/mise/config.toml tools: uv@0.10.5
% mise which uv
/Users/asmodai/.local/share/mise/installs/uv/0.10.5/uv-aarch64-apple-darwin/uv
% mise use uv@latest
uv@0.10.6                                                                                                                     
mise ~/.config/mise/config.toml tools: uv@0.10.6
% mise which uv
mise ERROR uv is a mise bin however it is not currently active. Use `mise use` to activate it in this directory.
mise ERROR Run with --verbose or MISE_VERBOSE=1 for more information
% mise where uv
/Users/asmodai/.local/share/mise/installs/uv/0.10.6
% ll `mise where uv`/*/uv
86464 -rwxr-xr-x@ 1 asmodai  staff  -   42M 25 feb. 00:42 /Users/asmodai/.local/share/mise/installs/uv/0.10.6/uv-aarch64-apple-darwin/uv*

So aside from a tiny version bump, nothing changed really.

Finally got it to work again by doing a mise uninstall uv@latest, followed by mise use uv@latest. But weird that after many weeks of working without an issue, it suddenly had this issue only for this version on macOS, despite many updates of uv via mise upgrade.