guumaster/dotfiles

Personal dotfiles for macOS — shell, editor, terminal, git, and system configs managed via a bare git repo.

What's here

Shell — Zsh with Zinit plugin manager, Starship prompt, modular setup (aliases, exports, functions)

Terminal — Ghostty config, htop, btop, bat, eza, fd, ripgrep, fzf

Git — delta diff pager, lazygit TUI, global gitignore, custom aliases

Editor — Neovim with vim-plug

macOS — Homebrew Brewfile (150+ packages, casks, Go/uv/npm tools), bootstrap scripts

Docs — full references under dotfiles/docs/:

Doc	Covers
Setup	How the bare repo works — clone, alias, commands
Tools	Tracked configs by category
macOS Bootstrap	New Mac setup step by step
SSH Identities	Multi-key setup for personal + work

Quick start

git clone --bare git@github.com-guuster:guumaster/dotfiles.git ~/.dotfiles.git
alias config='git --git-dir=$HOME/.dotfiles.git --work-tree=$HOME'
config checkout
config config status.showUntrackedFiles no

Add the config alias to your .zshrc, then:

config status     # see tracked files
config add <file> # track a new config
config diff       # review changes
config commit -m "…"
config push

New Mac setup

# 1. Clone and check out
git clone --bare git@github.com-guuster:guumaster/dotfiles.git ~/.dotfiles.git
git --git-dir=$HOME/.dotfiles.git --work-tree=$HOME checkout
git --git-dir=$HOME/.dotfiles.git --work-tree=$HOME config status.showUntrackedFiles no

# 2. Install packages (requires Homebrew)
brew bundle --file ~/dotfiles/Brewfile

See dotfiles/docs/macos.md for the full guide, including SSH setup and post-install steps.

How it works

This repo uses a bare git clone with $HOME as the working tree. Files stay at their native OS paths — no symlinks, no wrappers. The config alias lets you run git commands against $HOME/.dotfiles.git from anywhere.

Set status.showUntrackedFiles = no so config status only shows files you've explicitly added.