Dotfiles

This repo contains my macOS and Pop!_OS dotfiles and uses GNU Stow to manage symlinks.

Layout

Each top-level directory is a Stow package rooted at $HOME.

• zsh/.zshrc -> ~/.zshrc
• git/.gitconfig -> ~/.gitconfig
• nvim/.config/nvim/... -> ~/.config/nvim/...
• kitty/.config/kitty/... -> ~/.config/kitty/...

Bootstrap

Run:

./init.sh

On macOS this script will:

• install Homebrew if needed
• install the declared dependencies: git, delta, fnm, bob, stow, tmux, fzf, uv, pnpm, kitty, and JetBrainsMono Nerd Font
• install Oh My Zsh if needed
• install Neovim nightly with bob and verify the version is 0.12+
• create ~/.local/bin/env if it does not exist
• back up conflicting files and apply the repo with stow

On Pop!_OS/Ubuntu-like Linux this script will:

• install apt dependencies including git, zsh, stow, tmux, fzf, ripgrep, fd-find, cargo, and kitty
• install delta with apt when available, otherwise with Cargo
• install Oh My Zsh if needed
• install fnm, uv, and pnpm with their install scripts
• install bob with Cargo, then install Neovim nightly and verify the version is 0.12+
• create ~/.local/bin/env if it does not exist
• back up conflicting files and apply the repo with stow

The bootstrap is idempotent: package installs are skipped when the package or command is already present.

Manual Stow Usage

From the repo root:

stow --target="$HOME" --restow zsh git nvim kitty

If one of the target files already exists and is not managed by this repo, move it out of the way first or let init.sh back it up for you.