Personal machine provisioning and configuration management.

curl -fsSL https://raw.githubusercontent.com/leecheneler/dotfiles/main/apply.sh | bash

Same command for fresh machines and updates - it's idempotent.

Google Chrome, VS Code, Docker Desktop, Kitty, Rectangle, 1Password, 1Password CLI, Slack, Raycast, Claude, Claude Code, SuperWhisper

• zsh + zinit - Fast plugin manager with lazy loading
• Plugins - autosuggestions, syntax-highlighting, completions, history-substring-search
• Starship prompt - Git status, language versions, command duration
• Kitty terminal - GPU-accelerated, Tokyo Night theme

Declarative extension management - extensions not in the list are removed.

dotfiles/
├── apply.sh                 # Entry point (curl target)
├── Brewfile                 # Homebrew packages
├── scripts/
│   ├── lib/helpers.sh       # Shared helper functions
│   ├── packages.sh          # Homebrew install + bundle
│   ├── shell.sh             # Shell config symlinks
│   ├── vscode.sh            # VSCode settings + extensions
│   ├── git.sh               # Git config + SSH keys
│   └── ai.sh                # AI tooling config
├── bin/
│   └── init-copilot         # Bootstrap copilot instructions
└── config/
    ├── zsh/.zshrc           # Zsh + zinit config
    ├── kitty/kitty.conf     # Kitty terminal config
    ├── starship/starship.toml
    ├── git/.gitconfig       # Git configuration
    ├── vscode/              # VSCode settings + extensions
    ├── claude/              # Claude Code config (skills, agents)
    └── copilot/             # Copilot instructions template

1. Installs Xcode CLI tools (if missing)
2. Clones/updates this repo to ~/.dotfiles
3. Installs Homebrew (if missing) and all packages
4. Backs up existing configs to ~/.dotfiles-backup/
5. Symlinks config files
6. Installs VSCode extensions (removes unlisted ones)

Uses mise for automatic version switching. When you cd into a directory with a version file, mise automatically installs (if needed) and activates the correct version.

Supported version files:

Quick start:

# Install a runtime
mise use node@22
mise use deno@2

# In a project, create a version file
echo "22" > .node-version
# or use mise
mise use node@22  # creates .tool-versions

Create ~/.zshrc.local for machine-specific config (not tracked in git):

# Example: work-specific paths
export PATH="/work/tools:$PATH"

Global Claude Code configuration is symlinked to ~/.claude/:

• CLAUDE.md - Global instructions (principles, security rules, workflow)
• settings.json - Permissions (deny/ask/allow), hooks, notifications
• skills/ - Fat skills with full instructions, auto-loaded by context
• agents/ - Thin agent runners for isolated execution contexts

Auto-loaded reference skills: coding (TypeScript, React, testing conventions).

Generate a project-specific CLAUDE.md by running /claude-md inside a Claude Code session. This analyzes the repo and creates a CLAUDE.md at the project root with stack, conventions, architecture, and gotchas.

Bootstrap .github/copilot-instructions.md into any repo:

cd your-project
init-copilot

This copies the template from config/copilot/ - edit it to add project-specific context.

Uses 1Password CLI for secrets management. Tokens are loaded on-demand to avoid authentication popups at shell startup:

load-secrets  # Loads GITHUB_TOKEN and GITHUB_PACKAGES_TOKEN

Never commit API keys or tokens.

Update all Homebrew packages, casks, and Brewfile entries in one command:

update-apps

This runs brew update, installs any new Brewfile entries, upgrades all formulae and casks, and cleans up old versions.

Stateless and idempotent. Removing something from config doesn't uninstall it - just stops managing it. Manual cleanup when needed (brew uninstall X).