Portable macOS dotfiles and setup notes for a personal workstation.
This repository intentionally avoids machine-private material. Keep credentials,
private host files, package-manager auth files, and local-only setup in ignored
local files such as ~/.zshrc.local.
shell/: zsh config and prompt themegit/: portable git configvim/: Vim defaultstmux/: tmux defaultskarabiner/: Karabiner-Elements hyper-key mappingshammerspoon/: Hammerspoon automationvscode/: editor settings, keybindings, and extension listiterm2/: iTerm2 theme/profile notesbettertouchtool/: BetterTouchTool preset export and notesmacos/: macOS defaults scriptscripts/: small AppleScript helpers
There is no one-shot bootstrap script in this repo. Install and review files manually so machine-specific state stays out of git.
Suggested manual setup:
- Copy or symlink
shell/.zshrcto~/.zshrc. - Copy or symlink
git/.gitconfigto~/.gitconfig. - Copy or symlink
vim/.vimrcto~/.vimrc. - Copy or symlink
tmux/.tmux.confto~/.tmux.conf. - Copy
karabiner/karabiner.jsonto~/.config/karabiner/karabiner.json. - Copy
hammerspoon/init.luato~/.hammerspoon/init.lua. - Import iTerm2, Divvy, and BetterTouchTool settings through those apps.
Package and app installation is intentionally not tracked here. Keep package lists in notes or regenerate them from the current machine when setting up a new computer.