Dotfiles

Install Homebrew.

Install Git (if for some reason the macOS default isn't firing): brew install git

Clone your dotfiles: git clone https://github.com/your-username/dotfiles.git ~/dotfiles

Run Brew Bundle from the repo: brew bundle --file ~/dotfiles/Brewfile

Install Mise & Runtimes: mise install

Stow your configs:

cd ~/dotfiles
stow --adopt .

Install Oh My Zsh (with the KEEP_ZSHRC=yes flag).

Sign in to atuin and sync. Then run atuin threads import to index existing agent sessions (atuin resume to search and resume them).

Secret Management

Secrets are managed with fnox, an age-based secret store. fnox is installed automatically via mise (declared in .config/mise/config.toml).

The .zshrc eval hook loads secrets into your shell environment:

eval "$(fnox activate zsh)"

New machine setup

On a new machine, run the bootstrap task to store your age private key (the key that decrypts your fnox secrets):

mise run fnox

This will prompt you to paste your AGE-SECRET-KEY-... private key and store it at ~/.config/fnox/age.txt (chmod 600). Keep a copy of this key somewhere safe (e.g. a password manager) — it cannot be recovered if lost.