Run and install tools
Run a package once or install it for your user. No configuration required.
Using packages
Run tools on macOS and Linux. Manage packages, dotfiles, and settings with Lua.
Run a package once or install it for your user. No configuration required.
Using packages
Configure your shell, Git, SSH, and more with Lua. Preview changes before applying them.
Writing a configuration
Keep resolved package versions between installs. Update selected tools or your configured packages.
Updates and offline use
Share a configuration across macOS and Linux. Use profiles for settings that differ between machines.
Using profiles
rb run ripgrep -- --hidden TODO .Declare packages and settings in init.lua:
local rb = require("rootbeer")
local zsh = require("rootbeer.zsh")
rb.package("ripgrep")
zsh.config({
history = { size = 10000 },
})Preview and apply the configuration:
rb apply --dry-run
rb apply
eval "$(rb env)"You can now use rg. Zsh must be installed to use the shell configuration; start it with zsh -l. See your configuration for setup, or browse packages.