Brad's dotfiles

Portable macOS/Linux configuration managed with GNU Stow.

Each top-level directory is a Stow package whose contents mirror $HOME.

Packages

Package	Target	Remote Linux use
zsh	~/.zshrc, ~/.zprofile, ~/.config/omz	Yes
tmux	~/.config/tmux	Yes
pi	portable ~/.pi/agent settings, models, extensions, themes	Yes
nvim	~/.config/nvim	Only with a compatible current Neovim
yazi	~/.config/yazi	If Yazi is installed
kitty	~/.config/kitty	Desktop machines only
ghostty	~/.config/ghostty	Desktop machines only

Purpose-built Pi agents

pi-agents/ contains the version-controlled definitions for the coding, 3D-printing, and Proxmox agents. These are application definitions rather than a Stow package: pi-agent selects an isolated runtime root through PI_CODING_AGENT_DIR, while local Pi packages provide shared platform behavior and domain-specific capabilities.

pi-agent --list
pi-agent doctor
pi-code
pi-print
pi-proxmox

Install development dependencies with pnpm install from pi-agents/. Runtime sessions, credentials, caches, generated model state, and installed user packages remain under ~/.pi and are not tracked.

Install

Clone into the home directory:

git clone https://github.com/brad-j/dotfiles.git ~/dotfiles
cd ~/dotfiles

Install Stow:

# Ubuntu/Debian
sudo apt install stow zsh

# macOS
brew install stow

Preview before applying:

stow -nv zsh tmux pi

Apply the portable remote packages:

stow zsh tmux pi

Restow after pulling changes:

git pull --ff-only
stow -R zsh tmux pi

Machine-local and secret state

Never commit:

• Pi authentication, provider API keys, sessions, package caches, or Epimetheus/Hindsight credentials
• SSH private keys
• shell history
• runtime state and logs

Pi's portable files are tracked under pi/.pi/agent. auth.json, epimetheus/, sessions/, npm/, caches, trust decisions, and generated model state remain machine-local.

Interactive shell API keys belong in ~/.config/secrets/env.zsh, with directory mode 700 and file mode 600. The tracked .zshrc sources it when present. Keep the authoritative copy in a password manager.

install -d -m 700 ~/.config/secrets
install -m 600 /dev/null ~/.config/secrets/env.zsh

Conflicts

Always run stow -nv first. If a real target file already exists, compare and back it up before removing it. Do not use stow --adopt without reviewing the resulting repository diff.