____              _           _       _    __ _ _
 |  _ \ __ _ _   _ ( )___    __| | ___ | |_ / _(_) | ___  ___
 | |_) / _` | | | |/ / __|  / _` |/ _ \| __| |_| | |/ _ \/ __|
 |  _ < (_| | |_| |  \__ \ | (_| | (_) | |_|  _| | |  __/\__ \
 |_| \_\__,_|\__, |  |___/  \__,_|\___/ \__|_| |_|_|\___||___/
             |___/

Setup

./install.sh

install.sh detects your OS (macOS / Ubuntu), installs packages, then symlinks configs into your home dir. It's idempotent — safe to re-run — and backs up any real files it would overwrite (*.bak.<timestamp>).

What gets linked

target	source
~/.zshrc	dotfiles/zshrc
~/.zgen.zsh	dotfiles/zgen.zsh
~/.tmux.conf	dotfiles/tmux.conf
~/.config/nvim/init.vim	dotfiles/init.vim
~/.gitconfig	dotfiles/gitconfig
~/.scripts	scripts/

CLI tools

Core (installed by install.sh)

tool	replaces	why
neovim	vim	the editor
tmux	—	terminal multiplexer
oh-my-zsh + zgen	—	zsh framework + plugin loader
fzf	—	fuzzy finder (Ctrl-T / Ctrl-R / Alt-C)
fd	find	fast, gitignore-aware file search
ripgrep (rg)	grep	fastest recursive search
bat	cat	syntax highlight + paging
eza	ls	colors, git status, --tree
zoxide (z)	cd	jump to frecent dirs
jq	—	JSON slicing
git-delta	git diff pager	syntax-highlighted diffs
gh	—	GitHub PRs/issues from the CLI

Recommended extras (install as needed)

tool	purpose
btop	system monitor
tealdeer (tldr)	command cheatsheets
lazygit	git TUI
yazi	terminal file manager
dust	disk usage (du)
duf	disk free (df)
procs	process viewer (ps)

Docker compose

docker-compose/ contains commonly used docker-compose files.