Rad Command Reference
This reference describes all the commands available in the Rad CLI tool.
Installation Commands
Installing Rad
You can install Rad using our official installer scripts:
terminal
→curl -LsSf https://radgems.dev/rad/install.sh | sh
Downloading Rad installer...
Installing Rad v0.1.0...
✓ Rad has been installed successfully!
Run 'rad --help' to get started.
Basic Commands
rad --help
Display help information about Rad commands
terminal
→rad --help
📦 Rad version: 0.1.0
⚡ Usage:
• rad [OPTIONS] [COMMAND]
🔍 Commands:
• install Install gems from the lockfile
• update Update dependencies to newer versions
• exec Execute a command in the context of the current bundle
• lock Create or display the Gemfile.lock
• env Display environment information
• config Manage rad configuration
• version Show rad version
• platform Platform compatibility commands
• check Check gem compatibility
• visualize Visualize dependency graph
💡 For more information on a command, run:
• rad COMMAND --help
rad check
Check gem compatibility with the current platform
terminal
→rad check
💎 RAD CHECK 💎
🔍 Checking gem compatibility
⚙️ Analyzing dependencies...
🔍 Checking gem compatibility
⚙️ Analyzing dependencies...
✅ ALL GEMS COMPATIBLE! ✅
🔍 All gems are compatible with your current platform
🚀 Your dependencies are ready to be installed
⏱️ Completed in 0.04s
rad env
Display environment information
terminal
→rad env
✨ RAD ENVIRONMENT ✨
📄 Environment
💎 Rad: 0.1.0
🌐 Platforms: macos-aarch64
⚙️ Rust: 1.86.0 (macos-aarch64)
📁 Full Path: /Users/localadmin/.cargo/bin/rad
📁 Config Dir: /Users/localadmin/Library/Application Support
🔒 OpenSSL Security
• Compiled: OpenSSL 3.4.1 11 Feb 2025 (Library: OpenSSL 3.4.1 11 Feb 2025)
📦 Git: git version 2.49.0
⚡ Ruby Environment Tools
📄 Build Metadata
🕒 Built At: 0.1.0
🔑 Git SHA: unknown
📋 Released Version: 0.1.0
📄 Platform Information
• Current Platform: darwin-arm64
• Compatible Platforms: darwin-arm64, ruby, macos-arm64
💡 Use 'rad env --gemfile' to include Gemfile details in the output
rad stats
View statistics about your Rad installation and project
terminal
→rad stats
📊 RAD STATISTICS 📊
📄 Project
• Gemfile: Gemfile
• Dependencies: 52
📄 Environment
• Platform: darwin-arm64
• Ruby: ruby 3.3.0 (2023-12-25 revision 5124f9ac75) [arm64-darwin23]
• Rad: 0.1.0
📄 Sources
• Rubygems: https://rubygems.org
• Platforms: darwin-arm64, ruby
📄 Gem Platforms
💡 Use 'rad stats --detailed' for more performance metrics
rad config
View and modify Rad configuration settings
terminal
→rad config
💎 RAD CONFIGURATION 💎
🔧 Available Settings:
• debug
💡 Use 'rad config <setting>' to see a setting's value
rad install
Install the dependencies specified in your Gemfile
terminal
→rad install
📦 Installing gems with default groups
🔄 Initializing installation...
Installation path: vendor/bundle
Platform: darwin-arm64 (compatible with: darwin-arm64, ruby, macos-arm64)
• Processing gems...
• Processing gem: noticed ✓ Using noticed v2.6.0
• Processing gem: sqlite3 ✓ Using sqlite3 v2.6.0
• Processing gem: pg ✓ Using pg v1.5.9
• Processing gem: googleauth ✓ Using googleauth v1.1.3
Creating binary stubs...
• ❌ Creating executable stubs No binary stubs created
✅ INSTALLATION COMPLETE! ✅
📊 Summary: 0 gems installed, 4 gems already present
📦 4 gems ready to use in 0.08s
💡 Pro Tip: Run 'rad exec ruby your_script.rb' to use these gems in your Ruby scripts
Rad is 3-8x faster than Bundler for cold cache operations. With a cold cache, Rad installs a large project (45+ gems) in about 6.30s compared to Bundler's 52.40s. Even with warm caches, Rad outperforms Bundler.
rad add
Add a new gem to your Gemfile
terminal
→rad add rspec --group=development,test
📦 Adding gem 'rspec' to groups: development, test
Updating Gemfile...
🔄 Resolving dependencies...
• Installing gems...
• Installing rspec-support v3.12.0
• Installing rspec-core v3.12.2
• Installing rspec-expectations v3.12.3
• Installing rspec-mocks v3.12.6
• Installing rspec v3.12.0
✅ 5 gems installed in 0.31 seconds
Updated Gemfile and Gemfile.rad
Advanced Commands
rad platform
Manage platform compatibility for your gems
terminal
→rad platform list
📦 Available platforms:
🖥️ Native platforms:
• ruby
• x86_64-darwin-22
• arm64-darwin-22
• x86_64-linux
🔄 Simulated platforms:
• aarch64-linux
• arm-linux
• x86-linux
• x86-mingw32
• x64-mingw-ucrt
• x64-mingw32
✅ Current platforms:
• ruby
• arm64-darwin-22
rad exec
Execute a command in the context of the current project dependencies
terminal
→rad exec rspec
📦 Running via Rad Exec (0.1.0)
.......................
Finished in 0.12 seconds (files took 0.31 seconds to load)
23 examples, 0 failures
rad exec provides a fast runtime environment with all your project's gems properly configured. It runs commands faster than bundle exec, setting up the correct Ruby environment with all necessary load paths and environment variables.
Exec Command Options
terminal
→# Examples of rad exec with different options
# Include only specific groups
rad exec --with development,test rspec
# Exclude specific groups
rad exec --without production rails console
# Skip development dependencies
rad exec --no-dev rails server
Performance Optimization
rad stats project
View performance statistics about your project
terminal
→rad stats project
Project statistics:
- Dependencies: 67
- Gem versions evaluated: 423
- Peak memory usage: 74 MB (Bundler would be sweating at 250+ MB by now)
- Resolution time: 103 ms (basically instant)
rad check --platform
Check gem compatibility with specific platforms
terminal
→rad check --platform arm64-darwin
✓ All gems are compatible with platform arm64-darwin
Configuration Commands
rad config get
View Rad configuration settings
terminal
→rad config get lazy_loading
lazy_loading = true
rad config set
Modify Rad configuration settings
terminal
→rad config set cache_ttl 43200
✓ Configuration updated:
cache_ttl = 43200
rad version
Display the current version of Rad
terminal
→rad version
📦 Rad version: 0.1.0
🚀 The modern dependency manager for Ruby