MacInventory
Never lose your Mac setup again.
Quick Start • Features • Installation
Why MacInventory?
Ever had that sinking feeling when your Mac dies and you realize you don't remember half of what you had installed? Or spent hours manually recreating your dev environment on a new machine?
MacInventory is your insurance policy. One command captures everything - apps, packages, configs, extensions - and creates restoration scripts that actually work.
| Without MacInventory | With MacInventory |
|---|---|
| 😰 "What Homebrew packages did I have?" | ✅ brew bundle --file=Brewfile |
| 😰 "Where were my VS Code settings?" | ✅ All configs backed up automatically |
| 😰 "What was my shell configuration?" | ✅ .zshrc, .bashrc, aliases saved |
| 😰 "How did I set up that app?" | ✅ Professional Restoration Guide |
⚡ Quick Start
# 1. Start up your Claude Code
claude
# 2. Install the plugin (one-time)
/plugin marketplace add ksk-incom/MacInventory
/plugin install macinventory@MacInventory
# 3. Run the inventory
/macinventory:inventory
That's it. Follow the prompts, and in minutes you'll have a complete snapshot of your Mac.
✨ What It Does
MacInventory solves a common problem: documenting your Mac's computing environment for hardware failures, migrations, or fresh starts. It automatically:
- 📱 Scans installed applications (system and user)
- 🍺 Catalogs Homebrew packages, casks, and taps
- 🛒 Lists Mac App Store apps
- 🔄 Detects version managers (pyenv, nvm, rbenv, asdf)
- 📦 Inventories global packages (npm, pip, pipx, cargo, gem)
- ✏️ Captures editor extensions (VS Code, Cursor, Zed, Sublime)
- 🔐 Backs up configuration files with secret filtering
- 📋 Generates restoration bundles (Brewfile, package lists)
- 💾 Creates a comprehensive
state.yamlsnapshot - 📖 Optionally generates a professional Restoration Guide
📥 Installation
From Claude Code
# Add the marketplace (one-time)
/plugin marketplace add ksk-incom/MacInventory
# Install the plugin
/plugin install macinventory@MacInventory
For Development
# Clone the repository
git clone https://github.com/ksk-incom/MacInventory.git
# Test locally without installing
claude --plugin-dir ./macinventory
🚀 Usage
Run the inventory command in Claude Code:
/macinventory:inventory
You'll be guided through options:
- Security Settings - Whether to include files that may contain secrets
- Guide Generation - Whether to create a Restoration-Guide.md
- Cloud Backup - Optionally copy output to OneDrive, iCloud, Dropbox, or Google Drive
📂 Output Structure
After running, you'll have a timestamped directory with everything you need:
~/mac-inventory/2025-12-24-183045/
├── 📄 state.yaml # Complete system state snapshot
├── 📖 Restoration-Guide.md # Step-by-step restoration guide
├── 📦 bundles/ # Ready-to-use restoration files
│ ├── Brewfile # → brew bundle --file=Brewfile
│ ├── MASApps.txt # Mac App Store apps
│ ├── *Packages.txt # npm, pip, pipx, cargo, gem, go
│ └── *Extensions.txt # VS Code, Cursor, Zed extensions
└── ⚙️ configs/ # Backed-up configuration files
├── shell/ # .zshrc, .bashrc, aliases
├── git/ # .gitconfig, .gitignore_global
├── ssh/ # SSH config (not keys!)
└── apps/ # Per-app configs organized by tier
🎯 Features
Three-Tier Discovery
MacInventory uses a smart tiered approach to discover application configurations:
| Tier | Source | Trust Level | What It Does |
|---|---|---|---|
| 1 | Curated Database | ✅ High | Uses exact paths from app-hints.yaml |
| 2 | MacOS Conventions | ⚠️ Medium | Scans standard config locations |
| 3 | AI Research | ⚠️ Medium | Web search for unknown apps |