Skip to content

Repository navigation

CLAUDE.md

Latest commit

 

History

History
42 lines (29 loc) · 3.18 KB

CLAUDE.md

File metadata and controls

42 lines (29 loc) · 3.18 KB
Raw

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

What this repo is

A chezmoi source directory for a macOS workstation. There is no build, no test suite, and no application code — every file is either a managed dotfile template or bootstrap glue.

Commands

make                  # full bootstrap: init, claude CLI, brew, brew bundle, chezmoi apply, node, fonts, wallpaper
make chezmoi          # apply only (also writes ~/.config/chezmoi/chezmoi.toml if missing)
make node             # create ~/.nvm, then `nvm install --lts`; nvm itself comes from the Brewfile
chezmoi diff          # preview what an apply would change — run this before applying
chezmoi apply         # push source -> $HOME
chezmoi managed       # list every path chezmoi owns
chezmoi target-path home/dot_zshrc   # source path -> real $HOME path

brew bundle --global reads home/dot_homebrew/Brewfile (applied as ~/.homebrew/Brewfile), so a new package must be added there, not installed ad hoc.

Source layout / naming

.chezmoiroot is home, so home/ is the chezmoi source root and everything above it (Makefile, bin/, assets/) is repo scaffolding that never lands in $HOME. Never landing is not the same as never being read: .chezmoiroot is chezmoi's own, and home/.chezmoi.toml.tmpl does include "../private/pass/ids.toml", so the root-level private/ submodule is read at init time (hence the make config target checks it out first). That config template resolves the Proton Pass secrets (GitHub PAT, Context7 key) once and caches them in ~/.config/chezmoi/chezmoi.toml (0600) as .github_pat / .context7; to rotate one, delete its key there and re-run chezmoi init.

chezmoi decodes filenames — the prefixes are meaningful, not cosmetic:

Source Applies to Meaning
home/dot_zshrc ~/.zshrc dot_ → leading dot
home/dot_claude/private_settings.json ~/.claude/settings.json private_ → mode 0600
home/dot_config/nvim/lua/plugins/lsp.lua ~/.config/nvim/lua/plugins/lsp.lua directories pass through unchanged

Renaming a file changes where it lands. When adding a dotfile, prefer chezmoi add ~/.foo over hand-crafting the name.

Editing rules

  • Edit files here, then chezmoi apply. Editing ~/.zshrc directly puts the two out of sync — pull such changes back with chezmoi re-add.
  • home/dot_p10k.zsh, home/dot_config/nvim/lazy-lock.json, and home/dot_config/gh/private_hosts.yml are tool-generated. Regenerate them with their own tool (p10k configure, :Lazy update, gh auth login) rather than editing by hand.
  • Shell config is split: dot_zshenv (read by every zsh, interactive or not — it exports DO_NOT_TRACK=1 to opt out of the skills CLI's default-on telemetry, which dot_zshrc could not cover), dot_zprofile (login-shell integrations: orbstack, rbenv), dot_zshrc (interactive: nvm, PATH, aliases, p10k), dot_zsh/functions/* (autoloaded one per file by the loop at the end of dot_zshrc).
  • Neovim is a LazyVim install: home/dot_config/nvim/lua/plugins/*.lua for plugin specs, lua/config/*.lua for options/keymaps.