Rootbeer

Manage your dotfiles with Lua!

Rootbeer is a dotfile manager that lets you define your system configuration in Lua scripts. Think chezmoi, but with the full power of a real scripting language instead of Go templates.

Documentation →

Quick Start

Install and bootstrap in one command:

# Clone an existing dotfiles repo
sh -c "$(curl -fsSL rootbeer.tale.me/rb.sh)" -- init tale/dotfiles

# Or start fresh
sh -c "$(curl -fsSL rootbeer.tale.me/rb.sh)" -- init

Then apply your configuration:

rb apply              # apply configuration
rb apply -n           # dry run (preview without writing)
rb apply personal     # apply with a profile

What It Looks Like

local rb = require("rootbeer")
local git = require("rootbeer.git")
local zsh = require("rootbeer.zsh")
local profile = require("rootbeer.profile")

git.config({
    user = {
        name = "Aarnav Tale",
        email = profile.select({
            default = "aarnav@personal.me",
            work = "aarnav@company.com",
        }),
    },
    editor = "nvim",
    signing = {
        key = "~/.ssh/id_ed25519.pub",
    },
})

zsh.config({
    env = { EDITOR = "nvim" },
    aliases = { g = "git", vim = "nvim" },
    prompt = '%F{cyan}%~%f %F{white}>%f ',
    history = { size = 10000 },
    evals = { "mise activate zsh" },
})

-- Conditionals — it's just Lua
if rb.host.os == "macos" then
    local brew = require("rootbeer.brew")
    brew.config({
        taps = { "homebrew/cask-fonts" },
        formulae = { "lsd", "delta", "mise" },
    })
end

Key Ideas

• Config is code — Lua, not templates. Loops, conditionals, functions, and modules.
• Plan & apply — rb.file(), rb.link_file(), and module calls queue operations. Nothing touches the filesystem until rb apply.
• Declarative modules — zsh, git, SSH, Homebrew, macOS, and more. Describe the end state as a table, rootbeer generates the files.
• Profiles — Manage multiple machines from one repo with profile.select, profile.when, and profile.config.
• Editor support — rb lsp sets up lua-language-server for full autocomplete and type checking.

Building

Requires Rust 1.79+.

cargo build           # → ./target/debug/rb
nix build             # → ./result/bin/rb

License

MIT