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).

Rex

• Cmd+P: open a project with nvim and Claude.
• Cmd+Alt+P: open a project with nvim and Pi. If the project is already open, this selects its Pi tab or creates one.

Pi reports working, blocked, done, and error states to Rex through the Program Status Protocol.

Keep Rex's appearance set to Dark and disable Settings > Interface > Panes > Match program backgrounds. Otherwise macOS appearance changes and Pi's fullscreen background can change Rex's colors.

Pi uses its fixed dark theme from .pi/agent/settings.json instead of deriving colors from the terminal.

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.