til/mise/look-in-ruby-version-dotfile.md

Look In Ruby Version Dotfile

Newer versions of mise specifically only look for tool versions in mise.toml as well as the asdf .tool-versions file. A lot of Ruby projects use the .ruby-version file to indicate the Ruby version of a project. To continue to use the .ruby-version file instead of migrating to mise.toml, you need to tell mise that you prefer to use the idiomatic version file.

I added the following line to my ~/.config/mise/config.toml file:

idiomatic_version_file_enable_tools = ["ruby"]

Now, whenever mise is looking for the specified Ruby version of a project, it will also look for .ruby-version.

Here is a full list of idomatic version files supported by mise.

See idiomatic_version_file_enable_tools as well as the Ruby-specific documentation for more details.