macOS
Homebrewverified · 100%
brew install chrubyprovider-native install command
brew / rank 1678
Install chruby with Homebrew
Ruby environment tool. Version 0.3.9 via Homebrew; verified from local package data.
install
Additional install commands
overview
Package summary
Ruby environment tool
Project links
Commands and aliases
- chruby-exec
history
Project history and usage
chruby is a minimal shell-based Ruby version switcher that changes the active Ruby by updating shell environment variables instead of using shims.
Project history
The GitHub repository was created in August 2012 and early tags begin with v0.0.1 on the same date. The README highlights a deliberately small design: update PATH and RubyGems environment variables, support bash and zsh, default to system Ruby, and keep the implementation around 100 lines.
chruby's README frames its design through anti-features: it does not hook cd by default, does not install executable shims, does not regenerate shims after gem installation, and does not require Rubies to live in the user's home directory.
Adoption history
The official README documents Homebrew installation, source installation, Arch AUR, Fedora Copr, FreeBSD ports, and pairing with ruby-install or ruby-build. The supplied package facts also show Homebrew, MacPorts, and Nix packaging.
How it is used
Users source chruby.sh from shell startup files and optionally source auto.sh to switch versions by reading .ruby-version files in the current or parent directories. Non-standard Ruby install directories can be appended to the RUBIES shell array.
Why package nerds care
chruby matters because it is the small-tool answer to heavier Ruby version managers. It plays well with package managers because it separates installing Ruby builds from selecting one in the shell, which keeps version switching inspectable and avoids shim directories.
Timeline
- 2012: Repository created and v0.0.1 tag published.
- 2012: v0.1.x releases established the shell-based switcher.
- 2013: v0.3.x line matured around auto-switching and compatibility.
- 2023: v0.3.9 released.
- 2025: Repository metadata shows continued maintenance activity.
Related projects
- Related projects include ruby-install, ruby-build, RVM, rbenv, rbfu, RubyGems, Bundler, JRuby, Rubinius, and MagLev.
Sources
security posture
Risk level: green
narrow executable package without higher-risk signals.
Risk classifier
green risk · low confidence · appliance
Why
- narrow executable package without higher-risk signals
Signals
- metadata:no-higher-risk-signals
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
~/.bashrc~/.zshrc/etc/bashrc/etc/profile.d/chruby.sh~/.bash_profile~/.zprofile.ruby-version~/.ruby-version
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
chruby-exec | executable | indexed executable | Discovered from the local executable index. |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version0.3.9
manager updated
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:chruby |
|---|---|
| Version | 0.3.9 |
| Package manager | Homebrew |
| Homepage | https://github.com/postmodern/chruby |
| Repository | https://github.com/postmodern/chruby |
| Bottle | not recorded |
| Service | none declared |
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation