Skip to content
nonrationalPublic

About

:neckbeard: Mostly macOS with a dash of GNU/Linux.

Topics

Resources

Stars

9 stars

Watchers

1 watching

Forks

Repository files navigation

ci

nonrational/dotfiles

Architectural Digest for $HOME.

Installation

curl -sS https://nonration.al/setup.sh | bash

What setup.sh does

On a Mac, setup.sh will...

  1. Install the Xcode Command Line Tools if they are missing.
  2. Install Homebrew if missing, then run brew bundle.
  3. Make Homebrew's bash your login shell (needs sudo).
  4. Initialize git submodules.
  5. Symlink home/ into $HOME (deploy.sh).
  6. Link the Karabiner and Sublime Text configs, load the clipboard bridge launch agent, and run gh auth login.
  7. Turn off "reopen windows on login", then apply the macOS defaults table and scripts/macos-bootstrap.sh.
  8. 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.

Checkpoints

A few steps along the way require human input. The script prints a numbered instruction, exits 1, and resumes when re-run.

  1. Finish the Command Line Tools installer.
  2. 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.
  3. Reboot, if the automatic restart fails.

A failed step prints failed: <name> and exits 2. Fix the cause and re-run.

What it does not do

  • Pull updates. It runs the checkout you have; git pull first to pick up new changes.
  • Upgrade software beyond what brew bundle does.
  • Support Intel Macs (the Homebrew path is /opt/homebrew) or Windows.
  • Undo anything. deploy.sh audit and make macos-audit report drift without changing it.

Clipboard bridge (exe.dev VMs)

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.

Development

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.

Credits

People whose good work I've borrowed, curated via /find-inspiration.

About

:neckbeard: Mostly macOS with a dash of GNU/Linux.

Topics

Resources

Stars

9 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages