📦 Stash

Encrypted backup for macOS dotfiles, secrets, and configs.

---

⚠️ Critical

Need BOTH to restore:

• 🔑 ~/.stash.key → Password manager
• 📦 .tar.gz.age → Cloud/external drive

Store separately. Lose either = lose everything.

---

Install

Homebrew:

brew install harshpatel5940/tap/stash

Go:

go install github.com/harshpatel5940/stash@latest

---

Usage

# Setup
stash init

# Backup
stash backup

# List backups
stash list

# Restore (copy .stash.key first!)
stash restore backup.tar.gz.age --interactive

---

What Gets Backed Up

• Dotfiles: Shell configs (.zshrc), git configs, etc.
• Secrets: SSH keys, GPG keys, AWS credentials.
• Dev Secrets: .env and .pem files from your projects.
• Configs: ~/.config (with smart exclusions like node_modules).
• Packages: Homebrew, npm, VS Code extensions, Mac App Store apps.
• Browser Data: Bookmarks, extensions, settings (Chrome, Firefox, Safari, Arc).
• Git Repos: Tracks all your git repositories for easy re-cloning.
• System: macOS defaults/preferences, custom fonts, shell history.

---

Flags

Backup:

• --skip-browsers - Skip browser data (saves space)
• --keep <n> - Keep only last N backups (default: 5)
• --dry-run - Preview what will be backed up
• --verbose - Detailed output
• --no-encrypt - Skip encryption (not recommended)

Restore:

• --dry-run - Preview
• --interactive - Pick/drop files (git-rebase style)
• --no-decrypt - Unencrypted backup

---

Interactive Restore

Opens editor with pick/drop list:

pick [FILE] ~/.bashrc (2.3 KB)
drop [FILE] ~/.ssh/id_rsa (skip this)
pick [DIR ] ~/.config

Change pick → drop to skip files. Save & close.

---

Config

Edit ~/.stash.yaml:

search_paths:
  - ~/projects
  - ~/work

exclude:
  - "*/node_modules/*"
  - "*/vendor/*"
  - "*/.git/*"

additional_dotfiles:
  - .custom_aliases

backup_dir: ~/stash-backups
encryption_key: ~/.stash.key

---

After Restore

# Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Restore packages
brew bundle --file=packages/Brewfile
cat packages/vscode-extensions.txt | xargs -L 1 code --install-extension

# Restart terminal
# Test SSH, AWS, etc.

---

Development

See CONTRIBUTING.md

make build
make test

---

License

MIT - see LICENSE

---

GitHub • Issues