dotfiles

Personal dotfiles for macOS (and Linux-friendly), managed with chezmoi. Bash is the primary shell; zsh works as a first-class alternative.

Layout

chezmoi's source tree lives under home/ (see .chezmoiroot). Names follow chezmoi conventions: dot_bashrc → ~/.bashrc, dot_config/... → ~/.config/..., and *.tmpl files are Go-templated (used for the macOS vs Linux Homebrew prefix).

home/
dot_bash_profile.tmpl # bash login: brew env -> shared env -> rc
dot_bashrc.tmpl # bash interactive
dot_zprofile.tmpl # zsh login
dot_zshrc # zsh interactive (parity with bash)
dot_gitconfig
dot_gitignore_global
dot_vimrc
dot_tmux.conf # legacy; superseded by zellij
dot_config/
shell/
env.sh # POSIX env shared by bash & zsh (PATH, exports)
aliases.sh # shared aliases + `repl`
functions.sh # personal utility functions
init.sh # prompt + mise + completions (shell-detecting)
starship.toml # functional, low-noise prompt
starship-minimal.toml # lean prompt used by `repl`

Both shells source the same ~/.config/shell/* files, so aliases/env/functions stay in one place.

Shell highlights

• repl — drops into a minimal-prompt subshell (lean starship-minimal). exit / Ctrl-D returns to the full prompt.
• reload — re-exec the login shell after config changes.

Toolchain conventions (go-forward)

• Homebrew installs the package managers themselves (mise, pixi, chezmoi, …).
• mise owns the Go and Node toolchains (replaces the old nvm/brew-go/GVM tangle).
• pixi owns Python (replaces pyenv/conda).
• pnpm is the default frontend package manager, run containerized via Podman.
• nono sandboxes Claude Code (claude always launches under nono).
• zellij is the terminal multiplexer (ported from the old tmux config).

Install

brew install chezmoi
chezmoi init --apply <this-repo>

To preview changes before applying: chezmoi diff.