[sapoepsilon]

What

setup.sh — a gum-driven linear setup wizard for provisioning a fresh mac. Walks each step top-to-bottom; at each step you pick what to install, then it moves on and exits.

Order:

ensure_clt → ensure_brew → ensure_gum → intro (consent + Minimum/Verbose)
▶ Shell (Oh My Zsh + p10k + plugins)
▶ Apps (formulae / terminals / casks — checklists)
▶ Config repos (clone each, asks for blank URLs and saves them back)
▶ Private repo (clone/pull)
▶ macOS defaults
▶ Keyboard shortcuts (capture/restore symbolichotkeys)

How it works

• setup.conf is the manifest (apps, config-repo URLs, private repo, macOS defaults). Populate once, commit to your private repo, run on a new mac. Generated from setup.conf.example and gitignored.
• Idempotent: brew installs skip what's already present; clones check first.
• Fresh-mac safe: no sudo/root in the script; editor resolution falls back through $EDITOR → nvim → vim → nano → vi; Homebrew noise silenced via HOMEBREW_NO_*.
• Consent screen before anything runs; per-step confirms.

Test

• ./setup.sh --selftest covers the config save-back logic.
• bash -n setup.sh passes.
• Full TUI needs an interactive terminal.

Notes

• Supersedes installOhMyZSH.sh on macOS (left in place for its Linux branches).