Migrate to mise for dependency management
Important
As of April 1st, 2025, mise is default tool version manager for GDK.
On July 31st, 2025, support for asdf is being dropped entirely. Please migrate to mise as soon as possible to avoid interruptions to your work.
mise is the tool version manager used by GDK. It manages dependencies, such as Ruby or Go, automatically for you. For every project, it reads a .tool-versions (or mise.toml) file to download, install, and provide these dependencies.
For example, if you run bundle exec, mise detects that project’s Ruby version based on the .tool-versions file and executes bundle in the context of it. This ensures that different projects can use different dependency versions without affecting your entire system or other projects.
Note: mise is not compatible with asdf and vice versa. Do not use both at the same time.
How to migrate
To migrate to mise, follow these steps from your GDK directory:
Run the migration command:
gdk rake mise:migrateThis Rake task automatically:
- Opts out of
asdf - Enables
misesupport - Installs the new local hooks and dependencies
- Re-bootstraps GDK
- Opts out of
Reconfigure and update GDK.
gdk reconfigure && gdk updateUninstall asdf if you’re not using it outside of GDK.
Troubleshooting
If you encounter problems with mise, see the troubleshooting page.