docs: clarify that MISE_CEILING_PATHS excludes the ceiling directory itself by jdx · Pull Request #8283 · jdx/mise

jdx · 2026-02-21T16:42:35Z

Summary

Clarifies that config files at the ceiling directory are excluded from search, not just directories above it
Adds a concrete example showing that /home/user/mise.toml is not loaded when MISE_CEILING_PATHS="/home/user"
Notes that this follows Git's GIT_CEILING_DIRECTORIES semantics

Closes #8281

Test plan

Verify rendered docs show the updated text correctly

🤖 Generated with Claude Code

Note

Low Risk
Documentation-only change with no runtime or configuration parsing behavior modifications.

Overview
Clarifies the ceiling_paths/MISE_CEILING_PATHS documentation to state that config files located in a ceiling directory are not loaded, and adds a concrete example illustrating the exclusion.

Also notes that this behavior intentionally matches Git’s GIT_CEILING_DIRECTORIES semantics.

^{Written by Cursor Bugbot for commit 8a2a55a. This will update automatically on new commits. Configure here.}

…itself The documentation for ceiling_paths was ambiguous about whether config files at the ceiling directory are included or excluded. Clarify that they are excluded, with a concrete example, and note the Git precedent. Closes #8281 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

gemini-code-assist · 2026-02-21T16:42:46Z

Summary of Changes

Hello @jdx, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request enhances the documentation for the MISE_CEILING_PATHS setting. The primary goal is to provide clearer guidance on how mise interprets ceiling directories, specifically addressing whether configuration files located directly within a ceiling path are included or excluded from the search. This clarification aims to prevent user confusion and ensure consistent understanding of the setting's behavior.

Highlights

Documentation Clarification: Clarified that config files located at a specified ceiling directory are excluded from the search, not just those in directories above it.
Concrete Example Added: Included an example demonstrating that /home/user/mise.toml is not loaded when MISE_CEILING_PATHS="/home/user", while subdirectories are still searched.
Git Semantics Alignment: Noted that this behavior aligns with Git's GIT_CEILING_DIRECTORIES semantics.

Changelog

settings.toml
- Updated the description for MISE_CEILING_PATHS to explicitly state that config files in the ceiling directory itself are excluded.
- Added a concrete example to illustrate the exclusion behavior.
- Included a note that the semantics are consistent with Git's GIT_CEILING_DIRECTORIES.

Activity

Closed issue `mise.toml` in the directory of MISE_CEILING_PATHS is ignored #8281.
The pull request was generated with Claude Code.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	`/gemini review`	Performs a code review for the current pull request in its current state.
Pull Request Summary	`/gemini summary`	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	`/gemini help`	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

gemini-code-assist

Code Review

The pull request successfully clarifies the behavior of MISE_CEILING_PATHS by explicitly stating that config files within the ceiling directory itself are excluded from the search. The addition of a concrete example and the reference to Git's GIT_CEILING_DIRECTORIES semantics significantly improve the documentation's clarity. The changes are consistent with the existing test suite and address the ambiguity regarding whether the ceiling directory is included in the search path.

Copilot

Pull request overview

This PR improves the documentation for the MISE_CEILING_PATHS setting to clarify that the ceiling directory itself is excluded from config file searches, not just directories above it. The change addresses a potential source of confusion by explicitly stating the behavior and providing a concrete example.

Changes:

Updated MISE_CEILING_PATHS documentation to explicitly state that config files at the ceiling directory are excluded
Added a concrete example showing /home/user/mise.toml is not loaded when MISE_CEILING_PATHS="/home/user"
Added note about Git's GIT_CEILING_DIRECTORIES semantics for familiarity

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

github-actions · 2026-02-21T16:59:41Z

Hyperfine Performance

`mise x -- echo`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`mise-2026.2.17 x -- echo`	22.5 ± 0.9	21.8	35.9	1.00
`mise x -- echo`	23.5 ± 0.8	22.7	35.1	1.05 ± 0.06

`mise env`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`mise-2026.2.17 env`	21.9 ± 0.6	21.2	26.9	1.00
`mise env`	22.2 ± 0.7	21.5	34.7	1.01 ± 0.04

`mise hook-env`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`mise-2026.2.17 hook-env`	22.5 ± 0.3	21.9	25.6	1.00
`mise hook-env`	22.9 ± 0.3	22.2	24.9	1.02 ± 0.02

`mise ls`

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
`mise-2026.2.17 ls`	20.2 ± 0.4	19.6	24.7	1.00
`mise ls`	20.4 ± 0.3	19.6	22.0	1.01 ± 0.02

`xtasks/test/perf`

Command	mise-2026.2.17	mise	Variance
install (cached)	124ms	124ms	+0%
ls (cached)	75ms	76ms	-1%
bin-paths (cached)	80ms	81ms	-1%
task-ls (cached)	810ms	794ms	+2%

@jdx

### 🚀 Features - **(install)** auto-lock all platforms after tool installation by @jdx in [#8277](#8277) ### 🐛 Bug Fixes - **(config)** respect --yes flag for config trust prompts by @jdx in [#8288](#8288) - **(exec)** strip shims from PATH on Unix to prevent infinite recursion by @jdx in [#8276](#8276) - **(install)** validate --locked before --dry-run short-circuit by @altendky in [#8290](#8290) - **(release)** refresh PATH after mise up in release-plz by @jdx in [#8292](#8292) - **(schema)** replace unevaluatedProperties with additionalProperties by @jdx in [#8285](#8285) - **(task)** avoid duplicated stderr on task failure in replacing mode by @jdx in [#8275](#8275) - **(task)** use process groups to kill child process trees on Unix by @jdx in [#8279](#8279) - **(task)** run depends_post tasks even when parent task fails by @jdx in [#8274](#8274) - **(task)** suggest similar commands when mistyping a CLI subcommand by @jdx in [#8286](#8286) - **(task)** execute monorepo subdirectory prepare steps from root by @jdx in [#8291](#8291) - **(upgrade)** don't force-reinstall already installed versions by @jdx in [#8282](#8282) - **(watch)** restore terminal state after watchexec exits by @jdx in [#8273](#8273) ### 📚 Documentation - clarify that MISE_CEILING_PATHS excludes the ceiling directory itself by @jdx in [#8283](#8283) ### Chore - replace gen-release-notes script with communique by @jdx in [#8289](#8289) ### New Contributors - @altendky made their first contribution in [#8290](#8290) ## 📦 Aqua Registry Updates #### New Packages (4) - [`Skarlso/crd-to-sample-yaml`](https://github.com/Skarlso/crd-to-sample-yaml) - [`kunobi-ninja/kunobi-releases`](https://github.com/kunobi-ninja/kunobi-releases) - [`swanysimon/markdownlint-rs`](https://github.com/swanysimon/markdownlint-rs) - [`tmux/tmux-builds`](https://github.com/tmux/tmux-builds) #### Updated Packages (2) - [`firecow/gitlab-ci-local`](https://github.com/firecow/gitlab-ci-local) - [`k1LoW/runn`](https://github.com/k1LoW/runn)

@jdx

## [2026.2.18](https://github.com/jdx/mise/compare/v2026.2.17..v2026.2.18) - 2026-02-21 ### 🚀 Features - **(install)** auto-lock all platforms after tool installation by @jdx in [#8277](jdx/mise#8277) ### 🐛 Bug Fixes - **(config)** respect --yes flag for config trust prompts by @jdx in [#8288](jdx/mise#8288) - **(exec)** strip shims from PATH on Unix to prevent infinite recursion by @jdx in [#8276](jdx/mise#8276) - **(install)** validate --locked before --dry-run short-circuit by @altendky in [#8290](jdx/mise#8290) - **(release)** refresh PATH after mise up in release-plz by @jdx in [#8292](jdx/mise#8292) - **(schema)** replace unevaluatedProperties with additionalProperties by @jdx in [#8285](jdx/mise#8285) - **(task)** avoid duplicated stderr on task failure in replacing mode by @jdx in [#8275](jdx/mise#8275) - **(task)** use process groups to kill child process trees on Unix by @jdx in [#8279](jdx/mise#8279) - **(task)** run depends_post tasks even when parent task fails by @jdx in [#8274](jdx/mise#8274) - **(task)** suggest similar commands when mistyping a CLI subcommand by @jdx in [#8286](jdx/mise#8286) - **(task)** execute monorepo subdirectory prepare steps from root by @jdx in [#8291](jdx/mise#8291) - **(upgrade)** don't force-reinstall already installed versions by @jdx in [#8282](jdx/mise#8282) - **(watch)** restore terminal state after watchexec exits by @jdx in [#8273](jdx/mise#8273) ### 📚 Documentation - clarify that MISE_CEILING_PATHS excludes the ceiling directory itself by @jdx in [#8283](jdx/mise#8283) ### Chore - replace gen-release-notes script with communique by @jdx in [#8289](jdx/mise#8289) ### New Contributors - @altendky made their first contribution in [#8290](jdx/mise#8290) ### 📦 Aqua Registry Updates #### New Packages (4) - [`Skarlso/crd-to-sample-yaml`](https://github.com/Skarlso/crd-to-sample-yaml) - [`kunobi-ninja/kunobi-releases`](https://github.com/kunobi-ninja/kunobi-releases) - [`swanysimon/markdownlint-rs`](https://github.com/swanysimon/markdownlint-rs) - [`tmux/tmux-builds`](https://github.com/tmux/tmux-builds) #### Updated Packages (2) - [`firecow/gitlab-ci-local`](https://github.com/firecow/gitlab-ci-local) - [`k1LoW/runn`](https://github.com/k1LoW/runn) ## [2026.2.17](https://github.com/jdx/mise/compare/v2026.2.16..v2026.2.17) - 2026-02-19 ### 🚀 Features - **(prepare)** update mtime of outputs after command is run by @halms in [#8243](jdx/mise#8243) ### 🐛 Bug Fixes - **(install)** use backend bin paths for per-tool postinstall hooks by @jdx in [#8234](jdx/mise#8234) - **(use)** write to config.toml instead of config.local.toml by @jdx in [#8240](jdx/mise#8240) - default legacy .mise.backend installs to non-explicit by @jean-humann in [#8245](jdx/mise#8245) ### 🚜 Refactor - **(config)** consolidate flat task_* settings into nested task.* by @jdx in [#8239](jdx/mise#8239) ### Chore - **(prepare)** refactor common code into ProviderBase by @halms in [#8246](jdx/mise#8246) ### 📦 Aqua Registry Updates #### Updated Packages (1) - [`namespacelabs/foundation/nsc`](https://github.com/namespacelabs/foundation/nsc)

…itself (jdx#8283) ## Summary - Clarifies that config files **at** the ceiling directory are excluded from search, not just directories above it - Adds a concrete example showing that `/home/user/mise.toml` is not loaded when `MISE_CEILING_PATHS="/home/user"` - Notes that this follows Git's `GIT_CEILING_DIRECTORIES` semantics Closes jdx#8281 ## Test plan - [ ] Verify rendered docs show the updated text correctly 🤖 Generated with [Claude Code](https://claude.com/claude-code)  --- > [!NOTE] > **Low Risk** > Documentation-only change with no runtime or configuration parsing behavior modifications. > > **Overview** > Clarifies the `ceiling_paths`/`MISE_CEILING_PATHS` documentation to state that config files located *in* a ceiling directory are **not** loaded, and adds a concrete example illustrating the exclusion. > > Also notes that this behavior intentionally matches Git’s `GIT_CEILING_DIRECTORIES` semantics. > > <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit 8a2a55a. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup>  Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

@jdx

### 🚀 Features - **(install)** auto-lock all platforms after tool installation by @jdx in [jdx#8277](jdx#8277) ### 🐛 Bug Fixes - **(config)** respect --yes flag for config trust prompts by @jdx in [jdx#8288](jdx#8288) - **(exec)** strip shims from PATH on Unix to prevent infinite recursion by @jdx in [jdx#8276](jdx#8276) - **(install)** validate --locked before --dry-run short-circuit by @altendky in [jdx#8290](jdx#8290) - **(release)** refresh PATH after mise up in release-plz by @jdx in [jdx#8292](jdx#8292) - **(schema)** replace unevaluatedProperties with additionalProperties by @jdx in [jdx#8285](jdx#8285) - **(task)** avoid duplicated stderr on task failure in replacing mode by @jdx in [jdx#8275](jdx#8275) - **(task)** use process groups to kill child process trees on Unix by @jdx in [jdx#8279](jdx#8279) - **(task)** run depends_post tasks even when parent task fails by @jdx in [jdx#8274](jdx#8274) - **(task)** suggest similar commands when mistyping a CLI subcommand by @jdx in [jdx#8286](jdx#8286) - **(task)** execute monorepo subdirectory prepare steps from root by @jdx in [jdx#8291](jdx#8291) - **(upgrade)** don't force-reinstall already installed versions by @jdx in [jdx#8282](jdx#8282) - **(watch)** restore terminal state after watchexec exits by @jdx in [jdx#8273](jdx#8273) ### 📚 Documentation - clarify that MISE_CEILING_PATHS excludes the ceiling directory itself by @jdx in [jdx#8283](jdx#8283) ### Chore - replace gen-release-notes script with communique by @jdx in [jdx#8289](jdx#8289) ### New Contributors - @altendky made their first contribution in [jdx#8290](jdx#8290) ## 📦 Aqua Registry Updates #### New Packages (4) - [`Skarlso/crd-to-sample-yaml`](https://github.com/Skarlso/crd-to-sample-yaml) - [`kunobi-ninja/kunobi-releases`](https://github.com/kunobi-ninja/kunobi-releases) - [`swanysimon/markdownlint-rs`](https://github.com/swanysimon/markdownlint-rs) - [`tmux/tmux-builds`](https://github.com/tmux/tmux-builds) #### Updated Packages (2) - [`firecow/gitlab-ci-local`](https://github.com/firecow/gitlab-ci-local) - [`k1LoW/runn`](https://github.com/k1LoW/runn)

Copilot AI review requested due to automatic review settings February 21, 2026 16:42

Copilot started reviewing on behalf of jdx February 21, 2026 16:43 View session

jdx enabled auto-merge (squash) February 21, 2026 16:43

gemini-code-assist bot reviewed Feb 21, 2026

View reviewed changes

Copilot AI reviewed Feb 21, 2026

View reviewed changes

jdx disabled auto-merge February 21, 2026 16:47

jdx enabled auto-merge (squash) February 21, 2026 16:47

jdx merged commit 00c6ba0 into main Feb 21, 2026
41 checks passed

jdx deleted the docs/ceiling-paths-clarification branch February 21, 2026 16:56

mise-en-dev mentioned this pull request Feb 21, 2026

chore: release 2026.2.18 #8259

Merged

BrewTestBot mentioned this pull request Feb 21, 2026

mise 2026.2.18 Homebrew/homebrew-core#268760

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs: clarify that MISE_CEILING_PATHS excludes the ceiling directory itself#8283

docs: clarify that MISE_CEILING_PATHS excludes the ceiling directory itself#8283
jdx merged 1 commit intomainfrom
docs/ceiling-paths-clarification

jdx commented Feb 21, 2026 •

edited by cursor bot

Loading

Uh oh!

gemini-code-assist bot commented Feb 21, 2026

Uh oh!

gemini-code-assist bot left a comment

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

github-actions bot commented Feb 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

jdx commented Feb 21, 2026 • edited by cursor bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

gemini-code-assist bot commented Feb 21, 2026

Summary of Changes

Highlights

Footnotes

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

github-actions bot commented Feb 21, 2026

Hyperfine Performance

mise x -- echo

mise env

mise hook-env

mise ls

xtasks/test/perf

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

jdx commented Feb 21, 2026 •

edited by cursor bot

Loading

`mise x -- echo`

`mise env`

`mise hook-env`

`mise ls`

`xtasks/test/perf`