Dotfiles

This repository tracks selected shell and app config files for macOS.

Tracked files and folders:

• .zshrc
• .zprofile
• .zshenv
• .p10k.zsh
• .tmux.conf
• .config/nvim
• .config/tmux
• .config/ghostty
• .config/karabiner/karabiner.json
• .config/btop

Install

1. Clone the repository to ~/.config/dotfiles.
2. Install the tools your shell config expects:
   • Oh My Zsh
   • powerlevel10k
   • zsh-autosuggestions
   • zsh-syntax-highlighting
   • pyenv
   • pyenv-virtualenv
   • fzf
   • zoxide
   • tmux
   • nvim
   • openvpn
3. Point the generic VPN alias at your real config file if needed:

ln -sf "$HOME/.ssh/your-vpn-config.ovpn" "$HOME/.ssh/vpn.ovpn"

4. Run the link script from the repo root:

./scripts/link

5. Restart the shell:

exec zsh

Update

Pull the latest changes and re-run the link script if new files were added:

git pull --rebase
./scripts/link
exec zsh

Notes

• ~/.tmux.conf is a small compatibility shim that sources ~/.config/tmux/tmux.conf.
• The link script symlinks ~/.config/karabiner/karabiner.json only, so Karabiner backups stay local.
• ~/.config/nvim/.claude is left untracked on purpose.