dotfiles

Personal macOS dotfiles managed by chezmoi. Source of truth lives in this repo (~/dev/dotfiles); chezmoi renders/copies into ~.

Bootstrap a machine

brew install chezmoi
chezmoi init --apply rlch/dotfiles

You'll be prompted once for role:

role	machine	extras
`mbp`	MacBook Pro M5 Max	`Brewfile.heavy` (Ollama)
`mini`	Mac mini (or anything else)	base `Brewfile` only

The role is persisted to ~/.config/chezmoi/chezmoi.toml. Re-run chezmoi init to be re-prompted.

Day-to-day

chezmoi diff              # preview pending changes
chezmoi apply             # deploy
chezmoi cd                # cd into source dir
chezmoi edit ~/.config/foo/bar   # edit source for a deployed file

Edit files inside this repo (dot_config/..., dot_claude/..., Brewfile), not the deployed copies in ~ — the next chezmoi apply will overwrite them.

Stack

Concern	Tool
Manager	chezmoi
Shell	fish 4 + fisher
Terminal	Ghostty
Window manager	OmniWM
IDE	abyme
Prompt	starship
History	atuin
Versions	mise (node, python, go, bun)
Containers	OrbStack
AI CLI	Claude Code
Local LLM	Ollama (heavy hardware)
Browser	Firefox + tridactyl
Launcher	Raycast
Secrets	1Password CLI

Layout

.chezmoi.toml.tmpl    → renders ~/.config/chezmoi/chezmoi.toml on init
.chezmoiignore        → files in this repo that shouldn't deploy to ~
.chezmoiscripts/      → run-on-change install hooks (brew, fisher)
Brewfile              → base packages, every machine
Brewfile.heavy        → installed only when role = mbp
dot_claude/           → ~/.claude/ (Claude Code settings)
dot_config/           → ~/.config/ (everything else)

dot_ is a chezmoi prefix that maps to a leading . in ~. Other prefixes: private_ (0700/0600 perms), executable_ (0755), create_ (write once, never overwrite), run_onchange_ (script that re-runs when its rendered content changes).

See CLAUDE.md for the agent-oriented deep dive (conventions, invariants, common tasks).

Name		Name	Last commit message	Last commit date
.abyme		.abyme
.chezmoiscripts		.chezmoiscripts
.chezmoitemplates/agent-instructions		.chezmoitemplates/agent-instructions

Latest commit

History

Folders and files