Environment Dotfiles

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

• Shell: zsh
• Terminal: Ghostty
• Multiplexer: tmux
• Agent (primary): Cursor (rules in ./.cursor/rules/)
• Optional agents: OpenCode (tmux pane), Codex CLI (./.codex/ — not stowed by default)
• 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/tmux ~/.config/tmux.backup
   mv ~/.config/opencode ~/.config/opencode.backup
   mv ~/.config/zed ~/.config/zed.backup
   mv ~/.ssh/config ~/.ssh/config.backup

   ~/.codex is optional; only back it up if you already use Codex and plan to re-link it manually.

3. Create symlinks with Stow:

   cd ~/Developer
   stow -t ~ environment

4. Verify symlinks:

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

   Cursor picks up ./.cursor/rules/ when this repo is the workspace; Stow may also link ~/.cursor/rules to ./.cursor/rules from this package.

Tmux

• Entry command: t (create or attach to dev)
• Detach/reattach:
  • Detach: Ctrl+Space then d
  • Reattach: run t again
  • If already inside tmux, t switches your client to dev
• Default session/window: dev / environment
• Reset/rebuild layout: treset
• New page/window: Ctrl+Space then c (creates a new environment window with the same layout)
• Default layout:
  • left pane: nvim
  • right pane: opencode (TMUX_RIGHT_PANE_PERCENT=50)
• Status bar spacing: two-line top status bar with a blank second line for visual padding above panes

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)
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