Environment Dotfiles

A unified dotfiles setup using GNU Stow for managing development environment configurations. Yes, everything is setup to be in ~/Developer/ just to get the fancy little icon in Finder.

What's Included

• Shell: .zshrc with vi motions, fzf integration, and useful aliases
• Git: .gitconfig with sensible defaults and GitHub integration
• Terminal: Ghostty configuration with themes and custom settings
• AI Assistant: Opencode configuration for AI-powered development assistance
• Editors:
  • Neovim configuration based on kickstart.nvim
  • Zed settings with vim mode, custom fonts, and theme configuration

Quick Setup

Prerequisites

• GNU Stow: brew install stow
• Git (for cloning)

Installation

1. Clone this repository:

   git clone <your-repo-url> ~/Developer/environment
   cd ~/Developer/environment

2. Backup existing configs (optional):

   mv ~/.zshrc ~/.zshrc.backup
   mv ~/.gitconfig ~/.gitconfig.backup
   mv ~/.config/nvim ~/.config/nvim.backup
   mv ~/.config/ghostty ~/.config/ghostty.backup
   mv ~/.config/zed ~/.config/zed.backup

3. Create symlinks with Stow:

   cd ~/Developer
   stow -t ~ environment

4. Verify symlinks:

   ls -la ~/.zshrc ~/.gitconfig ~/.config/nvim ~/.config/ghostty ~/.config/zed

Usage

• Edit configs: Make changes directly in ~/Developer/environment/
• Changes sync automatically: Symlinks ensure changes appear in your home directory
• Version control: Commit changes with git for history and backup

Management Commands

# Create symlinks
cd ~/Developer && stow -t ~ environment

# Remove symlinks
cd ~/Developer && stow -D -t ~ environment

# Re-create symlinks (useful after updates)
cd ~/Developer && stow -R -t ~ environment

# Check what would be symlinked (dry run)
cd ~/Developer && stow -n -v -t ~ environment

Customization

Adding New Configs

1. Copy config files to ~/Developer/environment/
2. Remove originals from home directory
3. Run stow -R -t ~ environment to create symlinks

Sensitive Information

This repo is designed to be safe for public sharing:

• Uses GitHub no-reply email in .gitconfig
• No API keys, tokens, or passwords
• See .gitignore for excluded file types

For private configs, consider:

• Creating a separate private dotfiles repo
• Using environment variables for sensitive values
• Adding .local config files (already in .gitignore)

File Structure

~/Developer/environment/
├── .config/
│   ├── ghostty/          # Terminal configuration
│   ├── nvim/             # Neovim configuration (kickstart.nvim)
│   └── zed/              # Zed editor configuration
├── .gitconfig            # Git configuration
├── .opencode/            # Opencode AI assistant configuration
├── .zshrc               # Zsh shell configuration
├── .gitignore           # Git ignore patterns
├── AGENTS.md            # AI assistant guidelines
└── README.md            # This file

Dependencies

The configurations assume you have:

• fzf: For fuzzy finding (brew install fzf)
• pure prompt: Zsh prompt (npm install -g pure-prompt)
• Neovim: Modern vim (brew install neovim)
• Ghostty: Terminal emulator
• Zed: Modern code editor (https://zed.dev)

Troubleshooting

Symlinks not working?

• Ensure you're running stow from ~/Developer
• Check target directory with stow -n -v -t ~ environment

Configs not loading?

• Restart your shell: exec zsh
• Check symlink targets: ls -la ~/.zshrc

Want to start fresh?

• Remove symlinks: stow -D -t ~ environment
• Delete and re-clone repository
• Re-run setup steps