MACSTARTER/README.md
type-two dbd58ff11e MACSTARTER: interactive Mac setup script (brew/cask/mas, tweaks, keys, Tailscale)
Ultrabunt-style dialog checklist installer for fresh Intel/Apple Silicon Macs.
Bootstraps CLT + Homebrew, then categorized menus: core CLI, dev/AI CLIs,
network, media, Android, full Xcode, GUI apps, macOS tweaks, SSH/Tailscale
key setup, and the legacy macpress WordPress stack.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-17 14:58:30 +10:00

59 lines
2.4 KiB
Markdown

# 🍎 MACSTARTER
*Fresh Mac → fully loaded, without pissfarting around in terminal for hours.*
Little sibling of [UltraBunt](https://github.com/type-two/ultrabunt). Was once a fast
LAMP/WordPress installer for Intel & Apple Silicon Macs — now it's a full first-time
Mac setup script with UltraBunt-style checklist menus. (The WordPress bit is still
in there as a category, for old times' sake.)
## 🚀 Quick start
On a brand new Mac (Apple Silicon or Intel):
```bash
git clone https://gitea.partly.party/monster/MACSTARTER.git
cd MACSTARTER
./macstarter.sh
```
That's it. The script bootstraps everything it needs itself:
Xcode Command Line Tools → Homebrew → menus.
Pick **FULL SEND** from the main menu to install every recommended item in one go,
or dive into categories and tick exactly what you want. Safe to re-run —
everything checks before it installs.
```bash
./macstarter.sh --catalog # just print everything it can install
```
## 🎪 Categories
| Category | Highlights |
|---|---|
| **Core CLI tools** | git, jq, ripgrep, fzf, htop, btop, real rsync, bat, eza, tmux… |
| **Dev tools & AI CLIs** | node, GitHub CLI, Claude Code, Antigravity CLI/IDE |
| **Network & sync** | Tailscale, rclone, nmap, mtr |
| **Media** | ffmpeg, yt-dlp, imagemagick, VLC |
| **Android** | adb + fastboot (platform-tools), scrcpy |
| **Apple dev** | Full Xcode via App Store (license accept + first-run handled) |
| **GUI apps** | Brave, Warp, Raycast, Rectangle… |
| **macOS tweaks** | natural scrolling OFF, show extensions/hidden files, fast key repeat, screenshots to ~/Screenshots, no .DS_Store litter |
| **Keys & Tailscale network** | ed25519 SSH key + keychain agent, ~/.ssh/config defaults, Tailscale login/join, CLI alias |
| **WordPress (macpress classic)** | php, mariadb, wp-cli, one-shot local WP site |
## 📝 Notes
- Full Xcode needs you signed in to the App Store first (it's ~12GB, go make a coffee).
- Tailscale join opens the menu bar app for login — the script picks up once you're in.
- The SSH key step copies your new public key to the clipboard, ready to paste into
your tailnet boxes or GitHub.
- Scrolling/keyboard tweaks fully apply after you log out and back in.
- Everything logs to `~/macstarter-install.log`.
## ✅ Install policy
Apps install via `brew` (formulae + casks) or `mas` (App Store) only.
No curl-pipe-bash randomness beyond Homebrew's own installer.