Coming from RVM or rbenv
An RVM and rbenv alternative for your Mac
Last checked 17 November 2026
In short: RVM and rbenv with ruby-build compile Ruby from source on your Mac and switch it with a shell function or shims. Termhint installs a precompiled Ruby for Apple silicon, checks it against its publisher's proof before it runs, and switches it by folder from your existing .ruby-version. It can take over your RVM or rbenv Rubies and the gems that install commands. RVM and rbenv are free and run on Linux too; Termhint is a paid Mac app. Details below.
How RVM works
- Install:
\curl -sSL https://get.rvm.io | bash -s stable, after importing RVM's GPG keys (rvm.io). - Rubies:
rvm install 2.1.1"will download, compile and install" that Ruby. RVM may usesudoto install build dependencies, unless you turn that off withrvm autolibs disable(Installing Rubies). - Project files, in order of precedence:
.rvmrc(a shell script you have to trust),.versions.conf,.ruby-versionand therubyline in aGemfile..ruby-versionmay carry a gemset asruby@gemset, which RVM notes other managers do not read (Project workflow). - Gemsets: named sets of gems per Ruby, so projects do not share gems (rvm.io).
How rbenv and ruby-build work
- Switching:
rbenv initadds a line to your shell startup file that puts~/.rbenv/shimsfirst onPATH. Callingruby,gemorbundlegoes through a shim, which looks for.ruby-versionand runs that Ruby from~/.rbenv/versions/.rbenv local 3.1.2writes the file (rbenv README). - Installing:
rbenv installcomes from the ruby-build plugin. It downloads Ruby's source tarball, runs./configureandmake install. It "mostly does not verify that system dependencies are present", so the build tools and headers must be there first. Downloads are checked against checksums in its bundled definition files, and a new Ruby release needs a ruby-build upgrade before it can be installed (ruby-build README).
How Termhint does it
- Precompiled, not compiled. Ruby comes as a ready build from the jdx/ruby releases on GitHub. No compiler, no Homebrew libraries, no
sudo. - Checked before it runs. Each download must match the digest GitHub publishes for the file and carry a GitHub artifact attestation bound to the jdx/ruby repository. If either is missing or wrong, nothing is installed.
- Your files keep working. In each folder up to
/, Termhint reads.tool-versionsfirst, then.ruby-version. A leadingruby-is dropped, soruby-3.3.6works. Version files are read as data, never run. - No shims. zsh and bash switch
PATHwhen youcd, with shell builtins only, sorubyis the Ruby itself, not a wrapper. For cron and scripts where no prompt runs, usetermhint runtime exec.
termhint runtime list-remote ruby # what jdx/ruby has for this Mac
termhint runtime install ruby 3.3 # the newest 3.3.x
termhint runtime use ruby 3.3 # this folder: writes .tool-versions
termhint runtime use -g ruby 3.3 # the default outside pinned folders
termhint runtime use ruby system # leave Ruby alone in this folder
termhint runtime exec ruby@3.3 -- bundle exec rake
Versions live in ~/.local/share/termhint/runtimes/ruby/<version>. Ruby is one of 14 languages plus Xcode in the same manager (runtime manager).
Side by side
| RVM | rbenv + ruby-build | Termhint | |
|---|---|---|---|
| How Ruby arrives | Compiled from source | Compiled from source | Precompiled build from jdx/ruby |
| Signed or checked | RVM's own installer and releases are GPG-signed (security) | Ruby downloads match checksums in ruby-build's definitions | Ruby downloads need GitHub's digest and an artifact attestation |
| Switching | Shell function | Shims on PATH | zsh and bash builtins on cd, no shims |
| Project files | .rvmrc, .versions.conf, .ruby-version, Gemfile | .ruby-version | .tool-versions, .ruby-version |
| Gemsets | Yes | No | No |
| Rubies | MRI, JRuby, Rubinius and others | CRuby, JRuby, TruffleRuby, mruby, PicoRuby | CRuby builds from jdx/ruby |
| Platforms | Most Unix-like systems; Windows via Cygwin or WSL | Unix-like systems, macOS and Linux | macOS 14+, Apple silicon |
| Price | Free, Apache 2.0 | Free, MIT | $11.99 once, 7-day trial |
RVM: rvm.io, install, github.com/rvm/rvm (license). rbenv and ruby-build: their GitHub READMEs. Read on 17 November 2026.
Moving over from RVM or rbenv
In the app, Settings → Runtimes → Other Managers lists RVM, rbenv and chruby when they are on your Mac. From a terminal:
termhint runtime migrate --dry-run # what would move, and which rc lines would be turned off
termhint runtime migrate rvm # or: rbenv, chruby
termhint runtime migrate --undo # turn the old manager's lines back on
termhint runtime migrate --remove rvm # also remove RVM, once everything moved
- Termhint installs the same Ruby versions from jdx/ruby and makes the old manager's default its own default. For RVM it reads
~/.rvm/rubiesand the default from RVM's alias file. - It reinstalls each version's gems that install commands into the matching Termhint Ruby with
gem install. For RVM it reads that Ruby's gem folder and the@globalgemset. - It turns off the manager's lines in
~/.zshrc,~/.zprofile,~/.bash_profile,~/.bashrcand~/.profile. Each file is backed up, and each line gets#termhint-off#in front, so--undorestores it byte for byte. - Removing the old manager is a separate choice.
--removerunsbrew uninstallif Homebrew installed it and moves its folders to the Trash, only once every version installed and every gem moved.
Gems that are only libraries come back per project with bundle install. Gemsets do not carry over: Termhint has none.
Keep RVM or rbenv if
- You need Linux or Intel Macs. The precompiled Ruby is for Apple silicon only, and Termhint runs only on macOS 14+ on Apple silicon.
- You rely on gemsets,
.rvmrcor.ruby-env. Termhint reads only the version. - You pin Ruby with the
Gemfilerubyline alone. Termhint reads.ruby-versionand.tool-versions, not theGemfile. - You need JRuby, TruffleRuby, patches or your own
configureflags. Those need a source build. - You use fish. Termhint switches versions in zsh and bash.
- You want free and open source. Both are.
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). The same app also does zsh autocomplete, prompt themes and terminal colors. Other managers: asdf and mise, nvm, pyenv.
Termhint is not affiliated with RVM, rbenv, ruby-build or jdx/ruby.