🌟 Zach's dotfiles

Personal dotfiles for a fast, XDG-clean, and good-looking terminal environment. Managed with chezmoi.

📦 What's inside

Path	What
~/.zshenv	Bootstrap: sets ZDOTDIR to ~/.config/zsh, then sources the config below
~/.config/zsh/.zshenv	XDG base dirs, EDITOR/VISUAL, per-shell env
~/.config/zsh/.zprofile	Homebrew shell env (login shells)
~/.config/zsh/.zshrc	Interactive shell: history, completion, plugins, aliases
~/.config/wezterm/wezterm.lua	WezTerm: runtime theme switcher + auto light/dark
~/.config/starship.toml	Starship prompt

ZSH lives under ~/.config/zsh via ZDOTDIR, keeping $HOME clean — the only zsh file left in $HOME is ~/.zshenv, a tiny bootstrap that redirects there. No plugin manager — plugins are installed with Homebrew and sourced directly.

🚀 Tools

• Starship — prompt
• zoxide — smarter cd
• fzf + fd — fuzzy finder
• fzf-tab — fuzzy completion menu
• eza — ls replacement
• bat — cat/pager with syntax highlighting
• vivid — LS_COLORS generator
• zsh-autosuggestions, zsh-syntax-highlighting, zsh-history-substring-search
• WezTerm — GPU-accelerated terminal

🎨 Theming

Colors follow the macOS light/dark system appearance automatically:

• WezTerm — a "minimal" theme family auto-switches with the OS; CTRL+SHIFT+T opens a fuzzy theme picker.
• LS_COLORS (eza + completion) — dark → catppuccin-mocha, light → gruvbox-light-hard.
• Claude Code — COLORFGBG is set from the system appearance so its auto theme tracks the OS instead of getting stuck on light.

🔧 Setup on a new machine

One command, from a clean macOS install:

sh -c "$(curl -fsLS https://dotfiles.orlovsky.dev)"

install.sh is idempotent and takes the machine end to end:

1. Xcode Command Line Tools → Homebrew (installs each only if missing).
2. chezmoi + age + 1Password CLI/app — the tools needed before the first apply.
3. Pauses until you sign in to 1Password (enable Settings → Developer → Integrate with 1Password CLI, then unlock). This is the one unavoidable manual step — it backs both the age key and secrets.zsh.
4. chezmoi init --apply sadorlovsky, which then:
   • fetches the age key from 1Password (chezmoi-age-key, Private vault) via a run_before script — needed to decrypt ~/.ssh/config;
   • installs every Homebrew package + font (run_onchange → brew bundle);
   • clones fzf-tab (.chezmoiexternal.toml);
   • points ZDOTDIR at ~/.config/zsh via the managed ~/.zshenv.

Re-running the one-liner (or chezmoi apply) is safe — every step skips work already done.

Prefer to do it by hand?

brew install chezmoi age 1password-cli   # + install the 1Password app and sign in
chezmoi init --apply sadorlovsky         # age key is fetched from 1Password automatically

If the age key can't be fetched (no 1Password), place it manually first:

op document get chezmoi-age-key --vault Private > ~/.config/chezmoi/key.txt
chmod 600 ~/.config/chezmoi/key.txt

Automation

• install.sh — the bootstrap above (repo root, outside chezmoi's source).
• run_before_00-fetch-age-key.sh.tmpl — provisions the age key from 1Password before any encrypted file is read (no-ops once the key exists).
• run_onchange_before_install-packages.sh — runs brew bundle with the package list; re-runs automatically whenever that list changes.
• .chezmoiexternal.toml — clones/updates fzf-tab (refreshed weekly).

Fonts (Fairfax + JetBrains Mono) install automatically via brew bundle.

🔄 Updates

chezmoi update -v      # pull latest and apply
chezmoi add <file>     # stage a locally-changed dotfile back into the repo
chezmoi cd             # open a shell in the source dir to commit & push

📄 License

MIT