Skip to content

Modules

Configure tools such as Git, Zsh, and SSH from your Lua configuration.

Pull a module in with require("rootbeer.<name>"):

lua
local zsh = require("rootbeer.zsh")
local git = require("rootbeer.git")

Use Profiles for settings that differ between machines. For tools without a module, write their configuration files with the core API.

Shell

PageDescription
zsh~/.zshenv, .zprofile, .zshrc from one table.

Developer Tools

PageDescription
git~/.gitconfig and global gitignore.
ssh~/.ssh/config host blocks and includes.

AI Coding

PageDescription
ampAmp settings, MCP servers, AGENTS.md.
claude_codeClaude Code settings, permissions, LSP.

Package Managers

PageDescription
brewBrewfile + brew bundle for formulae, casks, MAS.

System

PageDescription
macmacOS Dock, Finder, hot corners, hostname, Touch ID.