🚀 Minimal and clean dotfiles for macOS, managed with GNU Stow.

• 🔧 Managed with GNU Stow for clean symlink-based configuration
• 🔐 Secure secrets management with .zshrc.local (local only)
• 🚀 Quick setup on new machines
• 📦 Includes: zsh configuration

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

# Oh My Zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# GNU Stow
brew install stow

# Zsh plugins
brew install zsh-autosuggestions zsh-syntax-highlighting

# Python package manager
brew install uv

# Ruby
brew install ruby

# 1. Install dotfiles
./install.sh

# 2. Add your secrets (optional)
nano ~/.zshrc.local  # or code ~/.zshrc.local

# 3. Reload shell
source ~/.zshrc

The install script automatically creates ~/.zshrc.local for your secrets (API keys, tokens, etc.).

export GITHUB_TOKEN="your_token_here"
export OPENAI_API_KEY="your_key_here"

Sensitive data goes in ~/.zshrc.local (automatically created, lives in your home directory):

dotfiles/zsh/.zshrc              → Public config (tracked in git)
dotfiles/zsh/.zshrc.local.example → Template (tracked in git)
~/.zshrc.local                    → Your secrets (local only, NOT in repo)

The .zshrc file automatically loads ~/.zshrc.local if it exists.

dotfiles/
├── zsh/
│   ├── .zshrc                   # Main zsh configuration
│   └── .zshrc.local.example     # Template for secrets
├── install.sh                   # Installation script
└── README.md

Feel free to fork this repo and customize it for your own setup! If you have suggestions or improvements:

1. Fork the repo
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is open source and available under the MIT License.

Give a ⭐️ if this project helped you!