Skip to content

Managing your system

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.