If you discover a security vulnerability in this repository, please open a GitHub Issue with the label security.
For sensitive disclosures, contact via GitHub private messaging.
This is a personal dotfiles repo. The following practices are enforced to prevent accidental credential exposure:
zsh/.config/zsh/conf.d/private.zsh— machine-local secrets, API keys, work tokens- Any
*.envfiles - SSH private keys
Always use private.zsh for:
- API tokens (
GITHUB_TOKEN,OPENAI_API_KEY, etc.) - Work-specific environment variables
- Machine-specific PATH additions
- Credentials of any kind
See zsh/.config/zsh/conf.d/private.zsh.example for a template.
- Private SSH keys (
~/.ssh/id_*— never add to dotfiles) .netrcfiles- Browser cookies or session tokens
- Cloud provider credentials (
~/.aws/credentials,~/.gcloud/) - Database passwords
The .pre-commit-config.yaml in this repo includes detect-secrets and detect-private-key hooks to catch accidental credential commits.
To install pre-commit hooks locally:
pip install pre-commit
pre-commit installThe included dutils ssh-setup (scripts/dutils/ssh_setup.py) generates Ed25519 keys (preferred over RSA) for separate personal and work GitHub identities — see docs/SSH.md. After generation:
- Add a passphrase to your key
- Use
ssh-agentor macOS Keychain to avoid re-entering it - Never share your private key
# Generate key with passphrase
ssh-keygen -t ed25519 -C "your@email.com"
# Add to macOS Keychain
ssh-add --apple-use-keychain ~/.ssh/id_ed25519Secrets are kept encrypted in the repo with age,
using your SSH key as the identity — see docs/SECRETS.md.
- Plaintext never lives in the repo; only
*.ageblobs and public.recipientsare committed, andsecrets/.gitignoreblocks anything unencrypted. detect-secrets(pre-commit) is the backstop that catches secrets accidentally added outsidesecrets/.
dutils secrets init # seed recipients from your SSH public key
dutils secrets add ~/.ssh/config
dutils secrets decrypt --all # restore on a new machineOn macOS, dutils vulns scans installed Homebrew packages for known CVEs using
Homebrew 7.0+'s built-in brew vulns (OSV.dev-backed advisory database).
dutils vulns # all findings
dutils vulns --severity high # only high+ severitydutils diagnose also prints a one-line summary of findings. This is a local,
on-demand check — deliberately not a CI gate, since the advisory database
changes over time and would fail unrelated builds on newly disclosed CVEs.
scripts/setup/macos.sh installs Homebrew and every formula/cask listed in brew/Brewfile. Review the Brewfile before running on a fork — it installs packages system-wide.