Resolving vars in tools version fails in tracked config when not in current directory

[mortenlj]

I have a project where I have defined a variable used in both a tool version and some environment variables.
When mise operates in the project directory, everything works as it should.

However, when mise does a check of tracked configs from a different directory (for instance looking for things to clean up), the resolution of variables fails:

mise WARN  error loading tracked config file ~/code/gjensidige/gappynator/.config/mise/config.toml: failed to parse template {{ vars.kubernetes_version }} in ~/code/gjensidige/gappynator/.config/mise/config.toml: error: Field `kubernetes_version` is not defined.
 --> __tera_one_off:1:9
  |
1 | {{ vars.kubernetes_version }}
  |         ^^^^^^^^^^^^^^^^^^

Contents of ~/code/gjensidige/gappynator/.config/mise/config.toml:

[vars]
kubernetes_version = "1.35"
gateway_api_version = "1.3.0"
aso_version = "v2.21.1"

[settings]
idiomatic_version_file_enable_tools = [
  "go"
]

[tools]
"aqua:kyverno/chainsaw" = "0.2.14"
cilium-cli = "0.16.9"
"go:github.com/elastic/crd-ref-docs" = "v0.3.0"
"go:sigs.k8s.io/controller-tools/cmd/controller-gen" = "0.17.2"
golangci-lint = "1.54.2"
kind = "latest"
kustomize = "5.4.2"
kubectl = "{{ vars.kubernetes_version }}"

[env]
KIND_CLUSTER_NAME = "{{ get_env(name='KIND_CLUSTER_NAME', default='gappynator') }}"
GAPPYNATOR_CONTEXT = "{{ get_env(name='GAPPYNATOR_CONTEXT', default='kind-' ~ get_env(name='KIND_CLUSTER_NAME', default='gappynator')) }}"
KIND_IMAGE = "{{ get_env(name='KIND_IMAGE', default='kindest/node:v' ~ vars.kubernetes_version ~ '.0') }}"
GATEWAY_API_VERSION = "{{ get_env(name='GATEWAY_API_VERSION', default=vars.gateway_api_version) }}"
ASO_VERSION = "{{ get_env(name='ASO_VERSION', default=vars.aso_version) }}"
KUBECTL_WAIT_TIMEOUT = "{{ get_env(name='KUBECTL_WAIT_TIMEOUT', default='180s') }}"

mise-doctor.txt

[jdx]

This happens because mise prune/clean has to render {{ vars.kubernetes_version }} for a tracked config while running from a different directory, and it renders with the vars of the current directory, not that project's. The project's own [vars] aren't available there, so the render fails.

The experimental identity install layout avoids this. It records what each project's templated versions rendered to when you use the project, and prune reads that record instead of re-rendering. If a project has no record yet, prune keeps every install of the templated tool until you use the project again. Enable it with:

[settings]
experimental = true
install_layout = "identity"

See Identity install layout. Existing installs stay where they are and keep working.

AI-assisted — Tool: Claude Code; model: anthropic/claude-sonnet-5-5; version: 2.1.317.