Skip to content
benjamingriffPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

 

History

146 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Dotfiles!

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...


📂 Repository Structure

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 zshrc will symlink .zshrc into ~/.zshrc.
  • Running stow nvim will symlink .config/nvim into ~/.config/nvim.

⚡ Installation

Clone the repo into ~/repos/dotfiles (or your preferred location):

git clone https://github.com/<your-username>/dotfiles.git ~/repos/dotfiles
cd ~/repos/dotfiles

Then run the install script to stow all packages:

./install.sh

This will symlink everything into the correct locations under $HOME.

Neovim prerequisites

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-cli

Without this, Python files may open with no Treesitter syntax highlighting, and :checkhealth nvim-treesitter will report tree-sitter-cli not found.

Neovim profiles

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-omarchy

The 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.

─────────────────────────────────────────

🔧 Managing Packages

• 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

─────────────────────────────────────────

👀 Checking Existing Symlinks

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.

─────────────────────────────────────────

📜 install.sh

The included script automates stowing all packages:

#!/usr/bin/env bash

install.sh - symlink all dotfiles with stow

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.

─────────────────────────────────────────

🛠 Best Practices

• 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.

─────────────────────────────────────────

🧭 Review Tooling

PR review docs live under docs/review/.

  • docs/review/config-plan.md
  • docs/review/usage-guide.md
  • docs/review/pr-review-cheatsheet.md
  • docs/sqlfluff.md
  • docs/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.

─────────────────────────────────────────

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages