Environment Dotfiles

Dotfiles setup using Stow. Yes, everything is in ~/Developer just to get the fancy little Finder icon.

• Shell: zsh
• Terminal: Ghostty
• Agents: OpenCode
• Editors: Neovim, Zed

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/opencode ~/.config/opencode.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/opencode ~/.config/zed

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

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

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