CLAUDE.md

This file provides guidance to Claude Code when working with code in this repository.

Overview

macOS dotfiles managed with GNU Stow. Each top-level directory is a stow package that mirrors the home directory structure.

make stow      # Apply all packages
make restow    # Re-apply all packages
make delete    # Remove all symlinks
stow zsh       # Apply single package

zsh/ — .zshrc, .zprofile, .zsh/: Oh-My-Zsh config, aliases, fzf, Catppuccin theme scripts
starship/ — .config/starship.toml: prompt config
nvim/ — .config/nvim/init.lua: Neovim with lazy.nvim and Catppuccin theme
zed/ — .config/zed/: Zed editor settings and keymap
ghostty/ — .config/ghostty/config: Ghostty terminal (Catppuccin auto light/dark, JetBrains Mono)
bat/ — .config/bat/themes/: Catppuccin bat themes
lazygit/ — .config/lazygit/: Catppuccin lazygit themes
yazi/ — .config/yazi/: file manager config and Catppuccin themes
kanata/ — .config/kanata/kanata.kbd: keyboard remapping (home row mods, caps→esc/lang, fn layer, hjkl arrows)
git/ — .gitconfig, .gitignore_global
Brewfile — all brew/cask/vscode/go dependencies (not a stow package)

Shell aliases replace standard commands: cat→bat, ls→eza, grep→rg, cd→z, find→fd, http→xh, code→zed
Default editor is nvim
README is in English
Brewfile updates: brew bundle dump --force --file=~/.dotfiles/Brewfile

zsh-syntax-highlighting plugin must be last in the plugins list
Suffix aliases (e.g., alias -s json=bat) auto-open file types with the mapped tool
Global aliases (e.g., alias -g C='| pbcopy') are pipe shortcuts