Coming from asdf or mise
An asdf and mise alternative for your Mac
Last checked 17 November 2026
In short: asdf and mise manage versions of many tools from one .tool-versions file, and mise adds environment variables and tasks. Termhint is narrower: 14 languages plus Xcode on a Mac, each with a built-in installer that checks the publisher's checksum and signature or attestation before anything runs. It reads the same .tool-versions and can take over your asdf or mise installs. If you use mise for tasks, env vars, Linux or tools like terraform, keep mise. Details below.
How asdf works
- Plugins. asdf knows no tools on its own. You add a plugin per tool, such as
asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git, and install that plugin's dependencies first (Getting Started). An asdf plugin is a shell script that runs whenever you install a tool (mise's asdf guide). - Shims. You put
~/.asdf/shimsfirst onPATH. When you run a tool, asdf looks up its version in.tool-versionsfiles from the current folder up to$HOME, "just-in-time". With no version found, the tool errors. - Other version files.
.nvmrcor.ruby-versionwork per plugin, once you setlegacy_version_file = yesin~/.asdfrc. - 0.16 rewrite. asdf 0.16.0 is a complete rewrite in Go.
asdf globalandasdf localbecameasdf set, andasdf shellandasdf updateare gone (Upgrading to 0.16.0).
How mise works
- One
mise.tomlholds a project's tools, environment variables and tasks. It runs on macOS, Linux and Windows, is written in Rust and is MIT licensed (mise.jdx.dev). - Version files. mise reads
.tool-versionsas it is, and.nvmrc,.python-versionand the like once you enable them per tool. - Switching.
mise activateupdatesPATHand environment variables at the prompt and when you change folders. Shims are there for programs that need a fixed path. - Tools. 1,000+ tools in its registry, from many backends (GitHub releases, aqua, npm, pypi, cargo and more), and it can run asdf plugins. Verification "depends on the tool" (Migrating from asdf).
How Termhint does it
- The same
.tool-versions. In each folder up to/, Termhint reads.tool-versionsfirst, then the tool's own file:.nvmrc,.node-version,.ruby-version,.python-version,.go-version,.java-version,.bun-version,.deno-version,.xcode-version. These are on by default. asdf's namesnodejs,golanganddotnet-corework. - No plugins. Each of Node, Go, Java (Temurin), Python, Ruby, Bun, Deno, Zig, Erlang, Elixir, Gleam, .NET SDK, Dart, Julia and Xcode has a built-in installer for precompiled builds. Nothing is compiled, and no install script runs.
- Every download checked, or refused. The check is anchored in the publisher: Node's
SHASUMS256.txtsigned by a Node release key, Go's hashes plus Google's checksum database, Python's and Ruby's GitHub attestations, Zig's minisign signature, and so on for each tool. A missing checksum or signature is a refusal, never a warning. Releases without such a proof are not listed. - No shims, no process per prompt. zsh and bash switch
PATH(andGOROOT,JAVA_HOME,DEVELOPER_DIR) with shell builtins when youcd. Scripts and cron usetermhint runtime exec; editors can point at~/.local/share/termhint/runtimes/<tool>/default. - Nothing installs on its own. A folder that pins a missing version prints one line with the install command.
termhint runtime install node 22 # also: lts, latest, 22.11.0
termhint runtime use node 20 # this folder: writes .tool-versions
termhint runtime use -g python 3.13 # the default: ~/.config/termhint/tool-versions
termhint runtime current # what this folder asks for, and whether it is installed
termhint runtime exec node@20 -- npm test # for scripts and cron
More on each language and its check: runtime manager. Xcode has its own page: xcodes alternative.
What mise and asdf do that Termhint doesn't
- Tasks. No
mise run, no task dependencies. - Environment variables. No
[env], no.envloading, no secrets. Termhint sets only the variables a tool needs, such asJAVA_HOME. mise.toml. Termhint does not read it. Pin the version in.tool-versionsas well.- Any tool. Only the 14 languages and Xcode above. No terraform, kubectl, jq, Rust, PHP or plugins of your own.
- Lockfiles. No
mise.lock. - Other systems and shells. No Linux, no Windows, no Intel Macs, no fish, Nushell or PowerShell. Termhint switches versions in zsh and bash on macOS 14+ with Apple silicon.
- Machine setup. Nothing like
mise bootstrapfor packages and dotfiles.
Side by side
| asdf | mise | Termhint | |
|---|---|---|---|
| Tools | Any tool with a plugin | 1,000+ in its registry, plus asdf plugins | 14 languages and Xcode |
| Config | .tool-versions | mise.toml, .tool-versions | .tool-versions, each tool's own file |
| Other version files | Per plugin, opt-in | Opt-in per tool | On by default |
| Switching | Shims | Shell hook, or shims | zsh and bash builtins, no shims |
| Download checks | Up to each plugin | Depends on the tool | Publisher's checksum plus signature or attestation, required |
| Env vars and tasks | No | Yes | No |
| Platforms | Linux, macOS | macOS, Linux, Windows | macOS 14+, Apple silicon |
| Price | Free, MIT | Free, MIT | $11.99 once, 7-day trial |
asdf: asdf-vm.com, github.com/asdf-vm/asdf. mise: mise.jdx.dev, github.com/jdx/mise. Read on 17 November 2026.
Moving over from asdf or mise
termhint runtime migrate --dry-run # what would move, and which rc lines would be turned off
termhint runtime migrate asdf # or: mise
termhint runtime migrate --undo # turn their lines back on
termhint runtime migrate --remove asdf # also remove asdf, once everything moved
- Termhint reads asdf's
installs/<plugin>/*with its defaults from~/.tool-versions, or mise'sinstalls/<tool>/*with its defaults from the plainname = "version"lines under[tools]in~/.config/mise/config.toml. - It installs those versions with its own checks and makes the defaults its own. Tools it does not manage, such as asdf's terraform, are listed first and left where they are.
- It reinstalls each version's global npm packages, gems with commands and pip tools into the matching Termhint version.
- It turns off the manager's lines in
~/.zshrc,~/.zprofile,~/.bash_profile,~/.bashrcand~/.profile, each backed up and undoable byte for byte. Removing the manager is a separate choice (--remove), only once everything moved.
The same takeover works in Settings → Runtimes → Other Managers, which also lists nvm, pyenv, RVM and the rest (nvm, pyenv, RVM and rbenv).
Keep mise or asdf if
- You use mise for tasks or env vars. Termhint has neither.
- You manage tools beyond these languages, such as terraform, kubectl or Rust.
- You work on Linux or Windows, or share one config with CI there.
- You use fish, Nushell or PowerShell, or an Intel Mac.
- You want free and open source. Both are MIT licensed.
Termhint fits if you are on an Apple silicon Mac, your languages are in the list, and you want each install checked against its publisher, with no shims and no plugins. It also brings zsh autocomplete, prompt themes and terminal colors in the same app.
What it costs
Every feature works for 7 days with no account and no card. After that, a one-time license: $11.99 for 1 Mac, $19.99 for 3, $29.99 for 5, plus VAT or sales tax where it applies (pricing, FAQ).
Termhint is not affiliated with asdf or mise. Parts of its runtime manager are ported from mise (MIT).