This repository contains a managed collection of dotfiles and configuration files for macOS, organized with GNU Stow. The goal is to keep everything modular, reproducible, and easy to set up on a new machine.
Here are some changes so I can inpect with hunk...
Each top-level directory in this repo is a stow package.
Inside each package, the directory structure mirrors the layout of $HOME.
For example:
dotfiles/ bin/ → contains local bin scripts ghostty/ → contains .config/ghostty/ goose/ → contains .config/goose/ nvim/ → contains .config/nvim/ opencode/ → contains .config/opencode/ sketchybar/ → contains .config/sketchybar/ skhd/ → contains .skhdrc starship/ → contains .config/starship/ tmux/ → contains .config/tmux/ yabai/ → contains .config/yabai/ yazi/ → contains .config/yazi/ zshrc/ → contains .zshrc
This means:
- Running
stow zshrcwill symlink.zshrcinto~/.zshrc. - Running
stow nvimwill symlink.config/nviminto~/.config/nvim.
Clone the repo into ~/repos/dotfiles (or your preferred location):
git clone https://github.com/<your-username>/dotfiles.git ~/repos/dotfiles
cd ~/repos/dotfilesThen run the install script to stow all packages:
./install.sh
This will symlink everything into the correct locations under $HOME.
This config uses nvim-treesitter on its main branch, which requires the tree-sitter CLI to install/compile parsers such as Python:
npm install -g tree-sitter-cliWithout this, Python files may open with no Treesitter syntax highlighting, and :checkhealth nvim-treesitter will report tree-sitter-cli not found.
The repository has two alternative Neovim Stow packages:
nvim— the existing work-focused configuration.nvim-omarchy— a portable snapshot of the LazyVim setup from the Omarchy machine.
Do not stow both because both provide ~/.config/nvim. To switch profiles:
stow -D nvim
stow -t "$HOME" nvim-omarchyThe Omarchy profile vendors its current Tokyo Night theme rather than retaining
the machine-specific symlink into ~/.config/omarchy. Its complete dependency
and installation notes are in
nvim-omarchy/.config/nvim/README.md.
It is intentionally not included in install.sh, which continues to install the
existing nvim profile by default.
─────────────────────────────────────────
• Stow a package stow -t ~ nvim This creates symlinks from dotfiles/nvim/.config/nvim/ into ~/.config/nvim/. • Unstow a package stow -D nvim This removes the symlinks created by stow. • Restow (update symlinks) stow -R nvim
─────────────────────────────────────────
Stow doesn’t keep a registry of what’s installed — it just creates symlinks. To see what’s currently linked:
ls -l ~ | grep '->' ls -l ~/.config | grep '->'
This shows which files and directories are symlinked and where they point.
─────────────────────────────────────────
The included script automates stowing all packages:
#!/usr/bin/env bash
DOTFILES_DIR="$(cd "$(dirname "$0")" && pwd)" cd "$DOTFILES_DIR"
PACKAGES=( bin ghostty goose nvim opencode sketchybar skhd starship tmux yabai yazi zshrc )
for pkg in "${PACKAGES[@]}"; do stow -R -t "$HOME" "$pkg" done
Run it once after cloning to set up your environment.
─────────────────────────────────────────
• Keep one package per app/tool for modularity. • Mirror the exact structure of $HOME inside each package. • Use stow -D to cleanly remove symlinks. • Use stow -R to refresh symlinks after making changes.
─────────────────────────────────────────
PR review docs live under docs/review/.
docs/review/config-plan.mddocs/review/usage-guide.mddocs/review/pr-review-cheatsheet.mddocs/sqlfluff.mddocs/rs-ssm.md
These docs cover the terminal-first workflow built around gh-dash and Hunk, plus the optional Neovim-native GitHub flow via snacks.nvim.
─────────────────────────────────────────