Zsh Dotfiles

Personal zsh configuration with modern tools, security-focused credential management, and AWS/GCP integration.

---

Features

• Modern prompt with Starship
• Auto-suggestions and fuzzy finding (fzf)
• Git aliases and shortcuts
• Enhanced file listing (eza, bat, tree)
• AWS EC2 management (SSH, start/stop instances)
• Google Cloud Platform integration
• Secure secrets management
• Conda Python environment support
• Ghostty terminal configuration (Catppuccin Mocha, transparency)
• iTerm2 dynamic profile for Claude Code sessions
• Claude Code terminal integration (itc function)
• Cursor/VS Code editor settings and keybindings

---

Quick Start

1. Clone Repository

git clone <your-repo-url> ~/dotfiles
cd ~/dotfiles

2. Bootstrap

./bootstrap.sh

Creates symlinks, backs up existing configuration, and sets up the secrets file. The following symlinks are created:

Source	Target
zsh/.zshrc	~/.zshrc
starship/starship.toml	~/.config/starship/starship.toml
ghostty/config	~/Library/Application Support/com.mitchellh.ghostty/config
iterm2/catppuccin-claude.json	~/Library/Application Support/iTerm2/DynamicProfiles/catppuccin-claude.json
cursor/settings.json	~/Library/Application Support/Cursor/User/settings.json
cursor/keybindings.json	~/Library/Application Support/Cursor/User/keybindings.json

Ghostty, iTerm2, and Cursor symlinks are created regardless of whether those apps are installed -- they are harmless if the app is not present.

Optionally edit credentials during setup or after:

vim zsh/.zshrc.secrets  # Add your AWS/GCP credentials

3. Install Tools

# Essential shell tools (required)
brew install starship zsh-autosuggestions tree bat fd eza fzf

# Terminal apps (optional, install whichever you use)
brew install --cask iterm2    # For Claude Code iTerm2 integration
# Ghostty: https://ghostty.org (manual install)
# Cursor: https://cursor.com (manual install)

# Cloud tools (optional)
brew install awscli
brew install --cask google-cloud-sdk

4. Reload Shell

source ~/.zshrc

5. Claude Code Integration (optional)

For setting up Claude Code with iTerm2 and Cursor, see CLAUDE-ITERM-SETUP.md.

---

File Structure

dotfiles/
├── zsh/
│   ├── .zshrc                   # Main shell configuration
│   ├── .zshrc.secrets.template  # Template for your credentials
│   └── .zshrc.secrets           # Your actual credentials (gitignored)
├── starship/
│   └── starship.toml            # Starship prompt configuration
├── ghostty/
│   └── config                   # Ghostty terminal configuration
├── iterm2/
│   └── catppuccin-claude.json   # iTerm2 dynamic profile for Claude
├── cursor/
│   ├── settings.json            # Cursor/VS Code user settings
│   └── keybindings.json         # Cursor/VS Code keybindings
├── bootstrap.sh                 # Bootstrap script (symlinks + security)
├── CLAUDE-ITERM-SETUP.md        # Claude Code + iTerm2 setup guide
├── TOOLS.md                     # Tool dependencies reference
└── README.md                    # This file