Runtime manager
One runtime manager for every language on your Mac
Last checked 17 November 2026
In short: a Mac that builds Node, Python and iOS apps often runs nvm, pyenv and xcodes side by side, each with its own install, shell setup and version file. Termhint is one menu-bar app that installs Node.js, Go, Java, Python, Ruby, Bun, Deno, Zig, Erlang, Elixir, Gleam, the .NET SDK, Dart, Julia and Xcode. It checks every download against its publisher's checksum and signature or attestation, and switches versions per folder from the version files you already have.
Seven managers, seven setups
Each of these tools is good at its job. The cost is that each one adds its own piece to your shell and its own file to your projects.
| Manager | Languages | How it hooks into the shell | Version file |
|---|---|---|---|
| nvm | Node.js | A shell function: nvm.sh is sourced from ~/.zshrc or another profile file | .nvmrc |
| pyenv | Python (CPython, PyPy and others) | pyenv init adds setup code to your startup files; a shims folder goes first on PATH | .python-version |
| rbenv | Ruby | rbenv init edits your shell startup files; shims | .ruby-version |
| SDKMAN! | Java and other SDKs | sdkman-init.sh is sourced at the end of ~/.zshrc | .sdkmanrc (usage) |
| asdf | Many, through plugins | Its shims folder is added to PATH | .tool-versions |
| mise | Many | mise activate zsh in ~/.zshrc (optional; shims for other cases) | mise.toml; also reads .tool-versions, .nvmrc, .python-version |
| xcodes | Xcode | A separate command-line tool, installed with Homebrew or Mint | .xcode-version |
| Termhint | 14 languages and Xcode | One marked block in ~/.zshrc (and in bash, if you set it up there) | .tool-versions plus each language's own file (below) |
From each project's own README or site on 17 November 2026.
asdf and mise already cover many languages with one tool. If one of them works for you, compare on the details: see Termhint vs asdf and mise.
What you get with Termhint
- One app, one hook. The same shell block that runs autocomplete and the prompt switches versions. zsh and bash both switch by folder, with shell builtins only, whether the app is running or not.
- Prebuilt downloads only. No compiling, no install scripts, no shims. A version lives in
~/.local/share/termhint/runtimes/<tool>/<version>. - Every download checked before anything in it runs. A missing checksum or signature is a refusal, never a warning. Releases without such a proof are not listed at all.
- Your version files keep working.
.nvmrc,.python-version,.ruby-version,.tool-versionsand the rest are read as data and never run. - A Settings pane as well as the command line. Settings → Runtimes lists every language, its versions and the releases for your Mac, with Set as Default and Remove.
Languages, sources and checks
| Language | Where the build comes from | How the download is checked | Folder version file |
|---|---|---|---|
| Node.js | nodejs.org | SHASUMS256.txt signed by a Node release key | .nvmrc, .node-version |
| Go | go.dev | Published hashes, plus the files as logged in Google's checksum database (sum.golang.org, pinned key), plus Google's Developer ID on its programs | .go-version |
| Java | Eclipse Temurin JDKs from Adoptium | Temurin's checksum and Adoptium's signature | .java-version |
| Python | CPython from python-build-standalone | SHA256SUMS plus GitHub attestation | .python-version |
| Ruby | Precompiled builds from jdx/ruby (Apple silicon) | GitHub digest plus attestation | .ruby-version |
| Bun | Its GitHub releases (from 1.0.24) | Published sums plus its maker's Developer ID signature | .bun-version |
| Deno | dl.deno.land (from 1.38.1) | Published sums plus its maker's Developer ID signature | .deno-version |
| Zig | ziglang.org | sha256 plus minisign signature (pinned key) | .tool-versions only |
| Erlang/OTP | Precompiled builds from erlef/otp_builds | Sigstore bundle | .tool-versions only |
| Elixir | Its GitHub releases (the 1.18 line) | sha256 plus GitHub attestation | .tool-versions only |
| Gleam | Its GitHub releases | sha256 plus Sigstore bundle | .tool-versions only |
| .NET SDK | Microsoft | SHA-512 from Microsoft's signed release JSON (PKCS#7, pinned DigiCert root) plus Microsoft's Developer ID | .tool-versions only |
| Dart | .sha256sum plus Google's or FLUTTER.IO's Developer ID on every program | .tool-versions only | |
| Julia | julialang.org | GPG signature (current release key only) | .tool-versions only |
| Xcode | Apple, with your developer sign-in, or an Xcode already in /Applications | pkgutil --check-signature on the .xip, then codesign --verify --deep --strict for Apple's team, then Gatekeeper | .xcode-version |
Every language also reads .tool-versions. Elixir 1.19 and later attest only a source SBOM and 1.17 and earlier nothing, so only 1.18 is offered; Elixir needs Erlang installed first. Ruby builds exist for Apple silicon only.
The commands
termhint runtime install node 22 # newest 22.x; also lts, latest, 22.11.0
termhint runtime install python 3.13
termhint runtime list-remote ruby # what the publisher has for this Mac
termhint runtime use node 20 # pin here: writes .tool-versions in this folder
termhint runtime use -g node 22 # the default outside pinned folders
termhint runtime current # what this folder asks for, and whether it is installed
termhint runtime exec node@20 -- npm test # for scripts and cron, where no prompt runs
termhint runtime uninstall node 20.20.2
Every command has its own help: termhint runtime install --help. In a folder that pins a version you don't have, the shell prints one line with the install command. Nothing installs on its own.
How a folder picks its version
TERMHINT_<TOOL>_VERSIONin the environment, if set.- Walking up from the folder: the nearest
.tool-versionsline for the tool, or the tool's own file. In one folder,.tool-versionscomes first. - Your defaults in
~/.config/termhint/tool-versions.
Only the first version in a file counts, comments are skipped and the request has to look like a version, so a cloned repository cannot point outside the store or make your shell run anything. system leaves a tool alone. Turn switching off in one shell with TERMHINT_RUNTIMES_OFF=1. Editors and GUI apps can use ~/.local/share/termhint/runtimes/<tool>/default.
Moving off your current managers
Settings → Runtimes → Other Managers lists what is on your Mac: nvm, fnm, Volta, nodenv, RVM, rbenv, chruby, pyenv, goenv, jEnv, SDKMAN!, asdf, mise, the Bun and Deno installers, Xcodes.app, and the languages Homebrew installed. The same works from the terminal:
termhint runtime migrate --dry-run # what would move and which lines would be turned off
termhint runtime migrate nvm pyenv # take over these two
termhint runtime migrate --undo # turn their lines back on, byte for byte
- Their versions are installed again as verified downloads, not copied from the old folders.
- Their defaults become Termhint's defaults.
- Global npm packages, gems with commands and pip tools are reinstalled into the matching Termhint version. Packages added with
npm linkare listed, not moved. - Their lines in
~/.zshrc,~/.zprofile,~/.bash_profile,~/.bashrcand~/.profileare backed up, then turned off with#termhint-off#in front. - Removing the old manager is a separate choice (
--remove, or "Also remove" in Settings), and happens only once every version installed and every global package moved. - Tools Termhint does not manage, such as asdf's terraform or SDKMAN's gradle, are listed first so you know what stays with the old manager.
Xcode too
Termhint lists Xcode releases from xcodereleases.com that run on your macOS, downloads them from Apple with your developer session (signed in once in Settings, kept in the Keychain) or adopts an Xcode already in /Applications. .xcode-version in a folder sets DEVELOPER_DIR. Changing the Mac's default Xcode and its first launch each ask for your password once, or not at all with the optional administrator helper in Settings → Runtimes → Xcode. Details: Termhint vs xcodes.
Coming from a specific manager
- nvm:
.nvmrc, signed Node downloads, global npm packages. - pyenv: prebuilt Python instead of compiling it.
- RVM and rbenv: precompiled Ruby and moving your gems.
- asdf and mise:
.tool-versionswithout plugins or shims. - Java version manager for Mac: one JDK per folder.
- xcodes: Xcode versions and simulators from the same app.
When to keep what you have
- You work on Linux, Windows or an Intel Mac. Termhint runs on macOS 14 or later, on Apple silicon only.
- You need a language Termhint doesn't offer, or a build it doesn't list (PyPy, an older Elixir, a source build with your own flags). asdf and mise have plugins for many more tools.
- You use fish. Termhint switches versions in zsh and bash only.
- You want free and open source. Every manager in the table above is; Termhint is a paid app.
What it costs, and how to remove it
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 (pricing). Runtimes you installed keep working if the license lapses. termhint uninstall --all undoes Termhint's shell blocks and links; your installed runtimes stay in ~/.local/share/termhint/runtimes until you delete that folder (troubleshooting).
Termhint is not affiliated with any of the projects named on this page.