dotfiles-MacBook

OS-native Stable

macOS (Apple Silicon / Intel) terminal environment. Homebrew + brew bundle, Ghostty, 1Password agent, native pbcopy clipboard — plus a committed tiling-desktop layer: AeroSpace, SketchyBar, and Karabiner.

Highlights

  • Homebrew + Brewfile
  • Ghostty + 1Password
  • AeroSpace · SketchyBar · Karabiner
  • macOS defaults

How it fits

The OS-native layer — Package manager, paths, clipboard — what changes with the OS. It builds on Core, which is vendored into its core/ directory. See the three-layer model for how the layers compose.

Getting started

git clone https://github.com/dotgibson/dotfiles-MacBook ~/dotfiles-MacBook
cd ~/dotfiles-MacBook
./bootstrap.sh --links-only --dry-run   # preview the symlink plan
./bootstrap.sh                          # Homebrew + brew bundle + symlinks
exec zsh
./bootstrap.sh --macos-defaults         # optional: apply system prefs

Core is already vendored in a clone. Flags: --dry-run/-n, --links-only, --no-brew, --set-shell, --macos-defaults.

What actually bites

  • Homebrew on either arch — Lives at /opt/homebrew (Apple Silicon) or /usr/local (Intel); .zprofile handles both. Packages live in the committed Brewfile (brew bundle), not install/packages.txt.
  • Native clipboard + keychain — Core's clip/clip-paste shell out to pbcopy/pbpaste; git credentials use the macOS keychain via osxkeychain.
  • 1Password SSH agent — .zprofile points SSH_AUTH_SOCK at the 1Password socket — comment it out if you do not use it.
  • A committed desktop layer — Beyond the terminal: AeroSpace (tiling WM), SketchyBar (menu bar, tokyonight-storm), and Karabiner (caps→ctrl/esc + a hyper layer) all live here and are themed to match Core.

Read next

View dotfiles-MacBook on GitHub ↗