brew-migrator

Brew Migrator 🍺

Port your /Applications to Homebrew Casks with a Charm-powered TUI.

  scan  →  match  →  select  →  install

Built with Bubble Tea, Bubbles, Lip Gloss, and Huh.

Features

• Live scanning — real-time table updates as apps are matched to casks
• Smart auto-selection — score >90 → ⭐ near perfect pre-checked, 50–90 → 🤔 maybe unchecked, <50 → ❓ questionable unchecked
• Keyboard-driven — ↓↑ navigate, space toggle, enter confirm
• Progress bars — animated installation with gradient progress
• History — persistent JSON-backed migration history
• All Charm — unified design system with lipgloss styling, spinners, borders, and huh confirmations

Quick start

# Install
go install github.com/ahmetyilmaz/brew-migrator@latest

# Or build from source
git clone https://github.com/ahmetyilmaz/brew-migrator.git
cd brew-migrator
go build -o bin/brew-migrator .
./bin/brew-migrator

Requires: macOS + Homebrew

How it works

1. Scan — discovers every .app bundle in /Applications
2. Match — runs brew search --cask for each app, scores candidates by name similarity
3. Select — presents an interactive checkbox list; ↓↑ to move, space to toggle
4. Install — brew install --cask with a live progress bar
5. History — browsable record of every migration attempt

Visual design

Thresholds

Architecture

main.go      — program entry, tea.NewProgram
tui.go       — all TUI screens (menu, scan, select, install, summary, history)
styles.go    — lipgloss colour palette and reusable style definitions
brew.go      — Homebrew ops, app scanner, fuzzy matching, scoring, history

Tech stack

• Bubble Tea — Elm-architecture TUI framework
• Bubbles — table, spinner, progress, viewport, help components
• Lip Gloss — terminal styling
• Huh — confirmation dialogs