OPERATIONAL

LLM SETUP KIT

FOR MAC

macOS APPLE SILICON IDEMPOTENT 17 PHASES

Phase 1: Benchmarks ↗ Phase 2: Hardware Guide ↗ Phase 3: Setup Kit

> SYSTEM_OVERVIEW

What It Does

$ ./audit.sh

Scan your current Mac. Compare installed software against the Brewfile. Identify coverage gaps before migration.

$ ./backup.sh

Export everything that matters. Configs, extensions, memory files, project data. Encrypt secrets with AES-256.

$ ./setup.sh && ./restore.sh

Bootstrap a new Mac in one command. 17 automated phases. Then restore your configs, data, and secrets.

> TOOL_MANIFEST

The Toolkit

audit.sh

Pre-migration readiness audit. 12-section scan comparing your installed state against the Brewfile. Catches gaps before you move.

37 FORMULAE 39 CASKS 39 MAS APPS 11 PLUGINS GIT REPOS

backup.sh

Export configs, data, and encrypted secrets. Claude Code settings and memory, VS Code + Cursor extensions, Raycast prefs, project artifacts.

CLAUDE CODE EDITORS RAYCAST AES-256 MANIFEST

setup.sh

17-phase idempotent bootstrap. From bare macOS to full LLM dev environment. Xcode CLI, Homebrew, 115 packages, Ollama models, configs.

17 PHASES --DRY-RUN IDEMPOTENT OLLAMA

restore.sh

Restore from backup on new Mac. SHA-256 manifest verification, Claude plugins, editor extensions, Raycast, project data, decrypted secrets.

SHA-256 INTEGRITY CHECK PLUGINS SECRETS

verify.sh

Automated post-setup verification. Checks 30+ CLI tools, 10+ GUI apps, config symlinks, Claude Code, SSH keys, Ollama, editor extensions.

30+ CLI TOOLS 10+ APPS SYMLINKS PASS/FAIL

Brewfile

Full system inventory. Every package, cask, and App Store app with exact IDs. The single source of truth for what gets installed.

37 FORMULAE 39 CASKS 39 MAS APPS 115 TOTAL

> MIGRATION_PROTOCOL

Migration Workflow

OLD MAC / STEP 01

Audit Current State

$ ./audit.sh

Review report, update Brewfile if needed

OLD MAC / STEP 02

Backup Everything

$ ./backup.sh

Creates backups/<timestamp>/ with manifest

OLD MAC / STEP 03

Push & Transfer

$ git push && airdrop backups/

Repo to GitHub, backups via AirDrop (contains secrets)

NEW MAC / STEP 04

Bootstrap

$ git clone <repo> && ./setup.sh

17 phases: Homebrew, 115 packages, Ollama, configs

NEW MAC / STEP 05

Restore

$ ./restore.sh backups/<timestamp>

Configs, extensions, project data, decrypted secrets

NEW MAC / STEP 06

Verify

$ ./tests/verify.sh

30+ automated checks, then manual checklist

> FEATURE_SET

Features

--dry-run Mode

Preview every action before committing. See what setup.sh would do without touching your system.

Idempotent

Safe to re-run. Every phase checks existing state before acting. No duplicate installs or overwrites.

AES-256 Encryption

Secrets (.env files, SSH keys) encrypted with AES-256-CBC and PBKDF2 key derivation. Your passphrase, your keys.

SHA-256 Integrity

Every backup includes a manifest with file checksums. Restore verifies integrity before touching your system.

17 Automated Phases

From Xcode CLI tools to Ollama models to config symlinks. One script, zero manual intervention required.

Apple Silicon Native

Built for M-series Macs. Ollama with Metal acceleration, ARM-native Homebrew, optimized for unified memory.

> INCLUDED_STACK

What Gets Installed

Ollama

5 models: qwen3-coder, qwen2.5-coder, deepseek-r1, glm-4

Claude Code

11 plugins, memory files, settings, per-project configs

VS Code + Cursor

86 extensions each, synced settings and keybindings

Raycast

Launcher with AI features, 38 extensions, window management

Ghostty + Starship + zoxide

GPU-accelerated terminal, custom prompt, smart navigation

Dev Toolchain

Node, Python, uv, Bun, Docker, Git, GitHub CLI, tmux

GET STARTED

CLICK TO COPY $ git clone && ./setup.sh

VIEW ON GITHUB