Skip to content

README.md

Latest commit

 

History

History
160 lines (118 loc) · 6.12 KB

README.md

File metadata and controls

160 lines (118 loc) · 6.12 KB

Dotfiles

Personal dotfiles for macOS and Ubuntu, managed with chezmoi.

What's Included

Core: Neovim (NvChad-based with LSP, FZF, Telescope), ZSH (Zinit, p10k, lazy-loading), Git (delta diffs, difftastic, aliases), Kitty + Ghostty terminals

Dev tools: Go (revive linter), Atuin (shell history), Broot, Ripgrep, LSD, Lazygit

System: Btop, Zellij, LinearMouse

Per-Tool Documentation

Each tool has its own README with detailed configuration reference:

Tool Config Location Documentation
ZSH dot_zshrc, dot_zsh_* ZSH.md -- aliases, functions, completions, performance
Neovim dot_config/nvim/ README -- keybindings, plugins, LSP
Ghostty dot_config/ghostty/ README -- themes, profiles, splits
Kitty dot_config/kitty/ README -- shortcuts, themes, diff
Git dot_gitconfig.tmpl below -- aliases, delta, difftastic
Atuin dot_config/atuin/ README -- shell history sync
Broot dot_config/broot/ README -- tree navigation, verbs
Btop dot_config/btop/ README -- resource monitoring
Lazygit dot_config/lazygit/ README -- git TUI with difftastic
Zellij dot_config/zellij/ README -- terminal multiplexer, vim keys
LSD dot_config/lsd/ README -- modern ls replacement
LinearMouse dot_config/linearmouse/ README -- mouse acceleration
Scripts scripts/ README -- utility scripts

Bootstrap

macOS

# Fresh Mac (no Homebrew needed):
sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply abhilast

# Or with Homebrew already installed:
brew install chezmoi && chezmoi init --apply abhilast

What happens: chezmoi prompts for email/name, installs Homebrew (if missing), runs brew bundle to install all packages from Brewfile, applies all configs, syncs Neovim plugins, and sets the default shell to ZSH.

Ubuntu / Debian

sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply abhilast

What happens: chezmoi prompts for email/name, installs base dependencies via apt (from Aptfile), applies all configs, syncs Neovim plugins, and sets the default shell to ZSH.

The bootstrap scripts detect the OS automatically -- Brewfile is used on macOS, Aptfile on Linux. All config files are identical across platforms; only the package installation differs.

Daily Workflow

chezmoi edit ~/.zshrc       # Edit config (opens in editor)
chezmoi apply               # Apply all changes to $HOME
chezmoi diff                # Preview what would change
chezmoi cd                  # Enter the source directory
chezmoi update              # Pull latest + apply (cross-machine sync)

Adding New Tools

chezmoi cd
# Add the tool to Brewfile (macOS) and/or Aptfile (Ubuntu)
# Add config files with chezmoi naming (dot_ prefix)
chezmoi apply
git add . && git commit && git push

Shell Helpers

Core shell helpers (from ZSH aliases and functions):

pj              # fuzzy-switch projects
wtn <branch>    # create/switch to a git worktree branch
wtl             # list/jump worktrees
wtr <target>    # remove a worktree
prn             # push branch + open PR via gh

Scripts

Utility scripts in scripts/ (on PATH via .zshenv):

  • benchmark.sh -- shell startup benchmarking with hyperfine
  • profile-zsh-startup.sh -- detailed zsh startup profiling
  • ghostty-theme-switcher.sh -- switch Ghostty themes
  • wt -- git worktree management helper
  • scripts/mac/ -- macOS helpers (dark mode, dock, audio)

Git Worktree Helper (wt)

A helper script at scripts/wt (on PATH after shell reload):

wt new cloudsync-pro hero-fix
wt ls cloudsync-pro
wt rm cloudsync-pro hero-fix
wt prune cloudsync-pro

Defaults:

  • Root workspace: ~/repos/skates
  • New worktree path: ~/repos/skates/<repo>-wt-<name>
  • Base branch: origin/main

Overrides:

  • WT_ROOT to change workspace root
  • WT_REMOTE_BASE to change default branch base

Git Configuration

Git config lives at root level (dot_gitconfig.tmpl) since it deploys to ~/.gitconfig. It uses chezmoi templates to set user email/name from prompts and auto-detect macOS dark/light mode for delta.

Aliases

Alias Command Purpose
st status -sb Short status
ll log --oneline --graph -15 Compact log
lg log --graph --pretty=... Decorated log
co checkout Switch branches
br branch Branch management
cm commit -m Quick commit
cam commit -am Commit all with message
d / dc diff / diff --cached View changes
dt / dtc difftool / difftool --cached Difftastic view
s / sp / sl stash / stash pop / stash list Stash shortcuts
f / fo fetch / fetch origin Fetch
p / pl push / pull Push/pull
rb / rbi rebase / rebase -i Rebase
cleanup merged branch cleanup Delete merged branches
find log grep Search commit messages

Diff Tools

  • Delta -- primary pager for all git diffs. Auto-detects macOS appearance (dark/light) via chezmoi template. Side-by-side with line numbers.
  • Difftastic -- structural diff tool (git dt / git dtc). Shows AST-level changes instead of line-level.
  • Nvimdiff -- merge conflict resolution (git mergetool). Uses diff3 conflict style.

Chezmoi Template Features

The git config uses {{ .email }} and {{ .name }} from chezmoi's data prompts, and detects macOS AppleInterfaceStyle at chezmoi apply time to set delta.light accordingly.

Validation

chezmoi doctor              # Health check
chezmoi verify              # All files match source
chezmoi diff                # No drift
hyperfine 'zsh -i -c exit'  # Startup benchmark (<200ms target)