Skip to content

feat(macos): one-command new-Mac app setup via Brewfile + picker TUI#6

Merged
yulonglin merged 1 commit into
mainfrom
mac-app-setup
Jun 17, 2026
Merged

feat(macos): one-command new-Mac app setup via Brewfile + picker TUI#6
yulonglin merged 1 commit into
mainfrom
mac-app-setup

Conversation

@yulonglin

Copy link
Copy Markdown
Owner

Summary

Make setting up a fresh Mac a reviewable, reproducible, one-command flow: a registry of GUI + App Store apps → a gum toggle TUI → a committed Brewfile → brew bundle, plus a post-install auth/signature checklist.

Split out of #4 (part 2 of 2) — the low-risk "new-Mac setup hygiene" half.

Changes

  • config/apps.conf — single-source registry (method|id|category|tier|default|name|desc|auth); official casks + mas only, no third-party taps
  • custom_bins/app-picker — gum toggle TUI → generates config/Brewfile (--defaults / --dry-run)
  • config/Brewfile — generated default selection (committed)
  • scripts/setup/auth-setup — post-install login checklist + spctl/codesign signature/notarization audit
  • install.sh — new --apps component (bootstrap gum → picker → brew bundle); folds in Finicky, replacing the standalone finicky install component
  • scripts/setup/setup-login-items + config/login_items.conf — bootstrap-once, additive menu-bar login-item seeding (never fights manual System Settings changes)
  • macos_settings.sh — Dock autohide + instant-show + tilesize 48
  • curl|bash hardening — prefer official brew formula for uv + Rust (helpers.sh install_rust_toolchain), TLS-pinned fallback on Linux
  • Prune zerobrew (experimental component); cull leftover iTerm colour schemes
  • supply-chain-security.md: GUI Apps & Brewfile + curl|bash policy sections; CLAUDE.md: "Install/manage Mac apps" quick-ref row
  • plans/2026-06-16-mac-app-setup-brewfile.md: design doc

Verification

  • All cask/formula tokens verified to exist via formulae.brew.sh.
  • Auto-updating GUI casks (chatgpt/claude/cursor/antigravity) carry real sha256 pins.
  • ⚠️ Runtime pending a real Mac: gum TUI selection round-trip, osascript login-item creation, spctl audit.

Known issue (from review of #4, not yet fixed here)

app-picker's gum pre-selection is comma-joined while row labels contain commas (e.g. Notion's "Notes, docs, and wiki"), so some default toggles won't pre-select. Output parsing is fine. Worth fixing before relying on the TUI; the committed Brewfile is unaffected.

Merge note

Shares 3 files with the AI-CLI-migration PR; one trivial "keep both" conflict in supply-chain-security.md if both merge.

🤖 Generated with Claude Code

Make setting up a fresh Mac a reviewable, reproducible, one-command flow.

- config/apps.conf: single-source registry (method|id|category|tier|default|name|desc|auth)
  for GUI + App Store apps; official casks + mas only, no third-party taps
- custom_bins/app-picker: gum toggle TUI → generates config/Brewfile (--defaults/--dry-run)
- config/Brewfile: generated default selection
- scripts/setup/auth-setup: post-install login checklist + spctl/codesign signature audit
- install.sh: --apps component (bootstrap gum → picker → brew bundle); folds in Finicky.
  Replaces standalone 'finicky' install component in config.sh
- scripts/setup/setup-login-items + config/login_items.conf: bootstrap-once, additive
  menu-bar login-item seeding (never fights manual System Settings changes)
- macos_settings.sh: Dock autohide + instant-show + tilesize 48
- Harden curl|bash installers: prefer official brew formula for uv + rust (helpers.sh
  install_rust_toolchain), TLS-pinned fallback on Linux
- Prune zerobrew (experimental component); cull iTerm colour schemes
- supply-chain-security.md: GUI Apps & Brewfile + curl|bash policy sections
- CLAUDE.md: 'Install/manage Mac apps' quick-reference row

Package names verified against formulae.brew.sh. Runtime (gum TUI, osascript
login items, spctl audit) pending Mac verification.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jun 17, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@yulonglin, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 59 minutes and 42 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 492c5164-33fa-4e68-982e-629f0ab5fcf3

📥 Commits

Reviewing files that changed from the base of the PR and between 07b120d and 9e2f7c7.

📒 Files selected for processing (17)
  • CLAUDE.md
  • claude/rules/supply-chain-security.md
  • config.sh
  • config/Brewfile
  • config/aliases.sh
  • config/apps.conf
  • config/experimental.yaml
  • config/login_items.conf
  • config/macos_settings.sh
  • custom_bins/app-picker
  • install.sh
  • iterm/onedark.itermcolors
  • iterm/onedarker.itermcolors
  • plans/2026-06-16-mac-app-setup-brewfile.md
  • scripts/setup/auth-setup
  • scripts/setup/setup-login-items
  • scripts/shared/helpers.sh
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch mac-app-setup

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions

Copy link
Copy Markdown

🤖 Hi @yulonglin, I've received your request, and I'm working on it now! You can track my progress in the logs for more details.

@github-actions

Copy link
Copy Markdown

🤖 I'm sorry @yulonglin, but I was unable to process your request. Please see the logs for more details.

@yulonglin yulonglin merged commit a57c37f into main Jun 17, 2026
6 of 7 checks passed
yulonglin pushed a commit that referenced this pull request Jun 17, 2026
Post-merge cleanup for PRs #5/#6:
- README/CLAUDE.md: replace remaining 'Gemini CLI' mentions with the actual
  installed/updated set (Codex, OpenCode, Antigravity CLI)
- docs/cross-tool-extensibility.md: repoint the now-deleted sync_claude_to_gemini.sh
  to sync_claude_to_antigravity.sh; note Gemini CLI retirement (2026-06-18)
- app-picker: descriptions containing commas (e.g. Notion) broke gum --selected
  pre-selection; normalise commas in labels so the CSV is unambiguous

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant