RBENV(1)

🦋 RBENV(1) — the Rbenv Manual, but make it cute 🦋

okay bestie, welcome to the Rbenv Manual 💖 this is the page that teaches you rbenv, and honestly? it's giving main character energy for your whole Ruby setup.

---

✨ NAME ✨

rbenv — manage your application's Ruby environment 👑

---

🌸 SYNOPSIS 🌸

rbenv <command> [<args>...]

---

💅 DESCRIPTION 💅

so here's the tea ☕ rbenv respects the .ruby-version file in a project directory, and the way it does that is by making sure that any ruby, gem, bundle, or other Ruby command invocation automatically invokes the Ruby version configured for that project. no cap. it just handles it. 🫶

the way it pulls this off is by generating shims for all Ruby executables. as long as the rbenv shims directory is prepended to PATH, rbenv automatically ensures transparent switching between Ruby versions. literally magic, but it's just PATH bestie. 🪄

and where does it look for available Ruby versions? in the $RBENV_ROOT/versions directory. remember that. it matters. 💖

---

🎀 COMMANDS 🎀

• rbenv global [<version>] — view or change the global Ruby version 🌍
• rbenv local [<version>] — view or change the local Ruby version 📍
• rbenv shell [<version>] — view or change the Ruby version for the current shell session 🐚
• rbenv version — view the currently active Ruby version and where it is set from 🔍
• rbenv versions — list all locally installed Ruby versions known to rbenv 📋
• rbenv install [<version>] — (provided by the ruby-build plugin) download and install a new Ruby version 📥
• rbenv rehash — regenerate shims for all known Ruby executables 🔄
• rbenv which [<command>] — view the executable path that a command resolves to 🧭
• rbenv init — help bootstrap rbenv into the current shell environment 🚀
• rbenv help [<command>] — view help text for any rbenv command 🆘

---

🌈 ENVIRONMENT VARIABLES 🌈

• RBENV_VERSION (default: read from .ruby-version file) — the Ruby version name to be used 💜
• RBENV_ROOT (default: ~/.rbenv) — the location where rbenv discovers Ruby versions, plugins, and other configuration 🏠
• RBENV_DEBUG — activates printing debug information about rbenv internals to standard error 🐛
• RBENV_HOOK_PATH — colon-separated list of paths searched for rbenv plugin scripts 🪝
• RBENV_DIR (default: $PWD) — directory to traverse bottom-up to locate the .ruby-version file 🧗

---

🧚 PLUGINS 🧚

as its core functionality, rbenv only switches between Ruby versions and does nothing else — but it offers a plugin mechanism to hook into and override almost any aspect of its default behavior. obsessed. ✨

the most common plugin for rbenv is ruby-build, which facilitates installing new Ruby versions into the $RBENV_ROOT/versions directory. 🍓

read more at https://github.com/rbenv/rbenv/wiki/Plugins 📖

---

💀 NOTES 💀

• https://github.com/rbenv/rbenv/discussions
• https://github.com/rbenv/rbenv/wiki
• https://github.com/rbenv/ruby-build#readme

---

👑 AUTHOR 👑

Mislav Marohnić

---

ok that's the whole page bestie, you ate that 💅 go forth and switch Ruby versions with confidence, iykyk 💖

and fr fr, this was rbenv 1.3.2, dated 2023-11-08, from the RBENV(1) manual page. periodt. 🌟