Architectural Digest for $HOME.
curl -sS https://nonration.al/setup.sh | bashOn a Mac, setup.sh will...
- Install the Xcode Command Line Tools if they are missing.
- Install Homebrew if missing, then run
brew bundle. - Make Homebrew's bash your login shell (needs
sudo). - Initialize git submodules.
- Symlink
home/into$HOME(deploy.sh). - Link the Karabiner and Sublime Text configs, load the clipboard bridge launch agent, and run
gh auth login. - Turn off "reopen windows on login", then apply the macOS defaults table and
scripts/macos-bootstrap.sh. - Reboot, only if this run applied the defaults for applications like iTerm, Amphetamine, and Moom.
On Linux, setup.sh initializes git submodules and deploys the home/ symlinks.
A few steps along the way require human input. The script prints a numbered instruction, exits 1, and resumes when re-run.
- Finish the Command Line Tools installer.
- Grant Full Disk Access to your terminal (System Settings > Privacy & Security), then restart it. The defaults audit cannot read Safari or Mail settings without it.
- Reboot, if the automatic restart fails.
A failed step prints failed: <name> and exits 2. Fix the cause and re-run.
- Pull updates. It runs the checkout you have;
git pullfirst to pick up new changes. - Upgrade software beyond what
brew bundledoes. - Support Intel Macs (the Homebrew path is
/opt/homebrew) or Windows. - Undo anything.
deploy.sh auditandmake macos-auditreport drift without changing it.
make clipboard-bridge loads org.nonrational.clipboard-bridge, a socket-activated launch agent on 127.0.0.1:2224 that answers image requests from the pasteboard and nothing else. home/.ssh/config.d/exe.conf reverse-forwards that port into every *.exe.xyz session and shares connections between windows; add Include config.d/*.conf as the first line of ~/.ssh/config once. Inside a VM, Claude Code's ctrl+v then pastes whatever image is on the mac clipboard. The VM half is the wl-paste shim in nonreagent/dotfiles; design and trust model: clipboard bridge design. The include is global, so OpenSSH's permission check on it gates every ssh: if they all start failing with Bad owner or permissions on ~/.ssh/config.d/exe.conf, chmod 644 the repo's copy.
Since live-copies are symlinked out, commit and push changes as necessary.
For big refactors, don't try to do it live; use a separate clone or worktrees.
People whose good work I've borrowed, curated via /find-inspiration.
Alex Hillman · alexknowshtml/claude-skills
chriskempson · chriskempson/tomorrow-theme
Jess Frazelle · jessfraz/dotfiles
Jesse Vincent · obra/dotfiles
Lars Kappert · webpro/dotfiles
Matt Pocock · mattpocock/skills
Paul Irish · paulirish/dotfiles
Sam Moore · samandmoore/dotfiles