Personal dotfiles
README.md

gitleaks

dotfiles #

Personal dotfiles for macOS and Linux, managed by chezmoi.

Quick Start #

sh -c "$(curl -fsSL get.chezmoi.io)" -- init --apply mauvehed

This downloads chezmoi, clones this repo, and runs the initial apply. On Linux, system packages (build-essential, zsh, Python build dependencies) are installed via apt first, then Homebrew, 1Password CLI, brew packages, and asdf runtimes are installed automatically.

Set Machine Type #

After the first run, edit the chezmoi config to set the machine type:

chezmoi edit-config

Set personal = true or work = true, then re-apply:

chezmoi --force apply

Known hostnames (e.g. cypher, airblade, computah) are auto-detected and don't require manual config.

1Password Integration #

Secrets are stored in 1Password and fetched via onepasswordRead in templates. After the initial apply:

eval $(op signin)
chezmoi apply

What's Managed #

Shell #

Tool Purpose
Zsh Shell
oh-my-zsh Shell framework and plugins
oh-my-posh Prompt theme engine
fzf Fuzzy finder with fd integration
zoxide Smart cd replacement
eza Modern ls replacement
bat Cat replacement with syntax highlighting

Shell Config Load Order #

  1. ~/.zshenv - XDG dirs, GPG, asdf env vars
  2. ~/.zprofile - Login shell (minimal)
  3. ~/.zshrc - Homebrew, PATH, oh-my-zsh plugins, oh-my-posh, fzf, zoxide, asdf, 1Password SSH agent, iTerm2 integration, ssh-tmux wrapper, Python venv auto-activation
  4. ~/.aliases - Alias aggregator (sources per-platform alias files)

Aliases #

Aliases are composed from templates in .chezmoitemplates/:

  • aliases_all.tmpl - Cross-platform (docker, fzf, eza, bat, zoxide, tailscale, mosh)
  • aliases_git.tmpl - Git shortcuts (ga, gb, gco, gd, gl, gp, gst)
  • aliases_macos.tmpl - macOS-only
  • aliases_linuxos.tmpl - Linux-only

Aliases use conditional checks to only activate when the target binary is present.

Dev Tools #

Tool Purpose
asdf Runtime version manager (Node.js, Python, Go)
direnv Per-directory environment variables (via Homebrew)
Neovim Editor with Lazy plugin manager
tmux Terminal multiplexer with Dracula theme
git With diff-so-fancy, SSH signing via 1Password

Packages #

Homebrew packages are defined in .chezmoidata/packages.yaml and installed via brew bundle. Packages are organized hierarchically:

  • core - Installed everywhere
  • personal.core / work.core - Machine-type specific
  • darwin / linux - OS-specific
  • personal.darwin / personal.linux - Machine-type + OS specific

Managed Configs #

  • ~/.config/git/config - Global git config (SSH signing, diff-so-fancy, URL rewrites)
  • ~/.config/nvim/ - Neovim with Lazy plugins
  • ~/.config/oh-my-posh/themes/ - Custom prompt themes
  • ~/.config/iterm2/ - iTerm2 profile and Dracula color scheme
  • ~/.config/btop/ - btop with Dracula theme
  • ~/.claude/ - Claude Code settings and hooks
  • ~/.ssh/ - SSH config (keys from 1Password)
  • ~/.tmux.conf - tmux with TPM and Dracula theme

Custom Scripts (~/.local/bin/) #

  • git-update - Batch-pull all repos under ~/gitwork/*/*/*
  • git-config - Set per-repo git user/email for multiple GitHub orgs
  • git-upstream - Git upstream management
  • brew-update - Homebrew update wrapper
  • crt.sh - Certificate transparency lookup
  • randkey - Random key generator
  • check_uptime.sh - Warn if uptime exceeds 60 days
  • fzf-git.sh - fzf git integration helpers

External Resources #

Managed via .chezmoiexternal.toml.tmpl with auto-refresh:

  • oh-my-zsh + zsh-syntax-highlighting plugin
  • MesloLGS Nerd Font files
  • fzf shell integrations
  • tmux Plugin Manager (TPM)
  • git-fuzzy
  • Dracula eza color theme

Security #

  • Secrets are fetched from 1Password at apply time via onepasswordRead
  • gitleaks runs via pre-commit hook and GitHub Actions
  • Git commits are signed with SSH keys via 1Password

Command Reference #

chezmoi diff                        # Preview changes before applying
chezmoi apply -v                    # Apply changes verbosely
chezmoi -R apply                    # Force refresh external resources
chezmoi edit <file>                 # Edit a managed file
chezmoi add <file>                  # Add a file to chezmoi
chezmoi add --template <file>       # Add as a template
chezmoi execute-template < f.tmpl   # Test template rendering
chezmoi data                        # View all template data
chezmoi update                      # git pull + chezmoi apply
chezmoi git status                  # Run git in chezmoi source dir

Resources #