Welcome to my dotfiles!

Managed with GNU Stow and split by platform.

Structure

Folder	Purpose
shared/	Cross-platform configs (used on both macOS and Linux)
mac/	macOS-only configs (none yet — reserved for future use)
linux/	Linux-only configs (awesome, zathura, mpv)

Each folder is a Stow root: every package inside mirrors its target path under $HOME (e.g. shared/nvim/.config/nvim/ → ~/.config/nvim/).

Usage

Stow a package from the folder it lives in, targeting your home directory. Back up or remove any existing config at the target first.

# cross-platform
stow -d shared -t ~ nvim kitty tmux zsh git yazi lazygit gh gh-dash tmux-sessionizer claude

# linux box
stow -d linux -t ~ awesome zathura mpv

The mac/ folder has no packages yet; stow from it the same way once it does (stow -d mac -t ~ <package>).

Notes

• shared/zsh/.zprofile sets ZDOTDIR=$HOME/.config/zsh; the rest of the zsh config lives under shared/zsh/.config/zsh/.
• tmux plugins are installed by tpm and are not versioned.
• shared/claude/ holds only authored Claude Code config (instructions, settings, skills); private session data is git-ignored.
• Secrets (gh hosts.yml, credentials, shell history) are git-ignored — see .gitignore.

Free (libre) software I use

Terminal	kitty
Window Mgr	awesomewm (Linux)
Editor	Neovim
File manager	yazi
Media player	mpv
PDF viewer	zathura

Suckless builds

suckless-build