Post-Install

Verify the rebuild before calling it done.

The repo now includes scripts and CI so the public site and the working setup can be checked instead of trusted. Run the scripts locally, then use the remaining manual checks as a final pass.

Verification order: generate artifacts if data changed, apply defaults, run the setup check, then finish the browser and Keyboard Maestro handoff.

Commands

These are the repo-level commands worth keeping close after a rebuild.

Rebuild generated files

Run after editing install data or package groups.

python3 scripts/generate_brew_artifacts.py

Rebuild search index

Run after editing the site pages.

python3 scripts/build_search_index.py

Verify workstation

Checks Homebrew installs and Dock/Launchpad defaults.

./scripts/verify-setup.sh workstation

Manual Final Pass

The scripts cover the repeatable parts. These are the checks still worth doing by eye.

  • Tap to Click and three-finger drag are both working.
  • Vivaldi opens as the default browser and uses DuckDuckGo by default.
  • Keyboard Maestro shortcuts are firing correctly for launcher and clipboard history.
  • VS Code sync has restored the expected extensions and editor feel.
  • Codex, Claude, Antigravity, and OrbStack are signed in and usable.
  • MailMate beta launches natively, accounts connect cleanly, and Logseq graphs open where expected.
  • BetterDisplay profiles apply correctly and Tailscale plus Little Snitch behave the way this machine expects.
  • Shottr, Kap, and Rectangle Pro all respond with the expected shortcuts.
  • Kopia can see the current repository and the NFS mirror path is mounted correctly before sync runs.

Local Preview and CI

The Pages site is static. It is easy to preview and validate before publishing.

Preview locally

python3 -m http.server --directory docs 8000 gives a quick local preview of the Pages site.

Validate docs

python3 scripts/check_docs.py checks internal file references and required Pages files.

Validate generated files

python3 scripts/generate_brew_artifacts.py --check catches drift between the data source and generated outputs.

Validate search index

python3 scripts/build_search_index.py --check catches drift between the public pages and the client-side search index.