[jdx]

https://entire.io/gh/jdx/mise/trails/76

Developers can select a mise environment for one checkout without editing the project's shared .miserc.toml or repeating an environment flag:

# .miserc.local.toml
env = ["native"]

Ordinary mise install and mise run dev commands then load mise.native.toml. Add .miserc.local.toml to your global Git ignore file (core.excludesFile) to keep this preference untracked across repositories, and create it separately in each worktree that needs it.

Discovery checks .miserc.local.toml before .miserc.toml and .config/miserc.toml at each directory level. Closer directories retain precedence over parents. The local file uses the existing settings/template loader: explicit fields override shared values, omitted fields remain inherited, and env = [] clears a shared selection. CLI flags and MISE_ENV still take precedence.

Validation covers shared/local precedence, inherited settings, nested directories, environment/CLI overrides, empty selections, templates, standalone local files, discovery ceilings and malformed TOML, alongside the existing miserc tests.

AI-assisted — Tool: Codex; model: OpenAI/GPT-6; version: unavailable.

---

Note

Low Risk
Additive early-config discovery with existing merge semantics; behavior change is limited to optional local files and is covered by new e2e tests.

Overview
Adds .miserc.local.toml so developers can pick a mise config environment per checkout (e.g. env = ["native"]) without changing committed .miserc.toml or passing -E every time.

Early miserc discovery now checks .miserc.local.toml before .miserc.toml at each directory on the walk toward parents; closer directories still beat ancestors. The local file uses the same loader and merge rules as shared miserc—set fields override, omitted fields inherit, env = [] clears a shared list, and MISE_ENV / CLI flags still win. Documentation describes gitignore via core.excludesFile and updates the precedence list.

An e2e script exercises override vs shared settings, nested dirs, templates, standalone local-only config, ceiling paths, and invalid TOML.

^{Reviewed by Cursor Bugbot for commit ec59af9. Bugbot is set up for automated code reviews on this repo. Configure here.}

Summary by CodeRabbit

• New Features

  • Added support for per-checkout .miserc.local.toml configuration files.
  • Local settings can override shared configuration, preserve inherited values, replace or clear environment selections, and use templates.
  • Configuration discovery now checks local files before shared files in each directory.
  • Command-line options and MISE_ENV continue to take precedence over configuration files.

• Documentation

  • Added guidance covering local environment selection, inheritance, precedence, file locations, and discovery behavior.

[coderabbitai]

Understand this PR’s impact

Explore downstream dependencies and potential security impact with Blast Radius.

View blast radius →

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository YAML (base), Central YAML (inherited), Organization UI (inherited)

Review profile: CHILL

Plan: Advanced

Run ID: 04b43084-d8db-40da-9069-98e189e549a9

📥 Commits

Reviewing files that changed from the base of the PR and between e9b3c21 and ec59af9.

📒 Files selected for processing (3)

• docs/configuration/environments.md
• e2e/config/test_miserc_local
• src/config/miserc.rs

Included review availability: Your plan provides up to 10 included reviews per hour; 6 remain after this review.

---

📝 Walkthrough

Walkthrough

The change adds .miserc.local.toml discovery before shared miserc files at each directory level. It documents inheritance and precedence rules. A new end-to-end test covers overrides, clearing, templates, discovery limits, and malformed TOML.

Changes

Local miserc selection

Layer / File(s)	Summary
Discovery and precedence src/config/miserc.rs, docs/configuration/environments.md	Miserc discovery checks .miserc.local.toml before .miserc.toml in each directory. The documentation defines inheritance, env replacement and clearing, and CLI or MISE_ENV precedence.
End-to-end validation e2e/config/test_miserc_local	The test covers shared and local selectors, child-directory inheritance, overrides, templates, ceiling paths, and invalid local TOML.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~15 minutes

Change: Feature

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely describes the main change: adding .miserc.local.toml override support.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 4 functions across 1 files. (2 skipped: 2 …
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[greptile-apps]

Confidence Score: 5/5

The PR appears safe to merge with no actionable correctness, security, or repository-rule violations identified.

Summary

Adds checkout-local miserc overrides through .miserc.local.toml.

• Discovers the local file before shared miserc files at each directory level.
• Preserves field inheritance while allowing explicit values, including env = [], to override shared settings.
• Documents precedence, Git-ignore guidance, and environment/CLI override behavior.
• Adds end-to-end coverage for precedence, nesting, templates, discovery ceilings, standalone files, and malformed TOML.

_{Reviews (1) · Last reviewed commit: "feat(config): support checkout-local mis..."}

[github-actions]

Instruction counts

Nothing was compared, and so nothing was gated. No series appears on both sides: either the base has no measurements recorded, or the two were measured on different runner classes, which are deliberately not comparable — counts shift between machine types by more than a real regression does.

New, nothing to compare against: env on jdx-perf-v1-ubuntu24.04-x64-mise-rust1.97.1-img5263c143, hook-env on jdx-perf-v1-ubuntu24.04-x64-mise-rust1.97.1-img5263c143, ls on jdx-perf-v1-ubuntu24.04-x64-mise-rust1.97.1-img5263c143, registry on jdx-perf-v1-ubuntu24.04-x64-mise-rust1.97.1-img5263c143, startup on jdx-perf-v1-ubuntu24.04-x64-mise-rust1.97.1-img5263c143

_{Only instruction counts gate. Wall clock is shown for context — on identical hardware it moves 4-20% run to run.}

_{Measured by tak — instruction-counted CLI benchmarks, stored in this repository's git notes.}

_{ec59af9efa00 vs e9b3c2164dd1 · measured on the runner, not pushed to the history.}