Skip to content

docs(hooks): clarify cross-file execution order #12295

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jdx merged 1 commit into from
Aug 22, 2026
Merged

docs(hooks): clarify cross-file execution order #12295

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions docs/hooks.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,13 @@ You can have mise automatically execute scripts during a `mise activate` session
without the `mise activate` shell hook installed in your shell—except the `preinstall` and `postinstall` hooks.
The configuration goes into `mise.toml`.

When the same hook type is defined in multiple loaded config files, mise runs every matching hook
rather than overriding hooks from lower-precedence files. Hooks run from the highest-precedence
config file to the lowest-precedence config file. Within a single config file, hooks defined as an
array run in the order listed. For example, hooks in `conf.d/a.toml`, `conf.d/b.toml`, and
`conf.d/c.toml` run as `c`, `b`, then `a` because later alphabetical fragments have higher
precedence. Put order-dependent hooks in one array when they need to run in alphabetical order.

## CD hook

This hook is run anytime the directory is changed.
Expand Down
Loading