docs: update README and AGENTS.md for clean command and snapshot restore

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

Author: fullstackjam

AGENTS.md

@@ -16,16 +16,17 @@ openboot/
 ├── cmd/openboot/         # main.go → cli.Execute()
 ├── internal/
 │   ├── auth/             # OAuth-like login, token in ~/.openboot/auth.json (0600)
-│   ├── brew/             # Homebrew ops, parallel install (4 workers), retry logic
-│   ├── cli/              # Cobra commands: root, snapshot, doctor, update, version
+│   ├── brew/             # Homebrew ops, parallel install (4 workers), retry logic, uninstall
+│   ├── cleaner/          # Diff current system vs desired state, remove extra packages
+│   ├── cli/              # Cobra commands: root, snapshot, doctor, clean, update, version
 │   ├── config/           # Embedded YAML (packages + presets), remote config fetch
 │   │   └── data/         # packages.yaml (9 categories), presets.yaml (3 presets)
 │   ├── dotfiles/         # Clone + stow/symlink with .openboot.bak backup
-│   ├── installer/        # Main orchestrator: 7-step wizard (693 lines)
+│   ├── installer/        # Main orchestrator: 7-step wizard + snapshot restore (git/shell/packages)
 │   ├── macos/            # `defaults write` preferences, app restart
-│   ├── npm/              # Batch install with sequential fallback
+│   ├── npm/              # Batch install with sequential fallback, uninstall
 │   ├── search/           # Online search via openboot.dev API (8s timeout)
-│   ├── shell/            # Oh-My-Zsh install, .zshrc config
+│   ├── shell/            # Oh-My-Zsh install, .zshrc config, snapshot restore (theme/plugins)
 │   ├── snapshot/         # Capture/match/restore environment state (see subdir AGENTS.md)
 │   ├── system/           # RunCommand/RunCommandSilent, arch detection, git config
 │   ├── ui/               # TUI components (see subdir AGENTS.md)
@@ -45,9 +46,11 @@ openboot/
 | Add CLI command | `internal/cli/` | Register in root.go init(), follow cobra pattern |
 | Add package category | `internal/config/data/packages.yaml` | Rebuild after changing embedded YAML |
 | Change install flow | `internal/installer/installer.go` | 7 steps: homebrew → git → preset → packages → shell → macos → dotfiles |
+| Change clean/uninstall | `internal/cleaner/cleaner.go` | Diffs current vs desired, calls brew/npm Uninstall |
 | Add TUI component | `internal/ui/` | Use bubbletea Model pattern, lipgloss styling |
-| Change brew behavior | `internal/brew/brew.go` | Parallel workers, StickyProgress for output |
+| Change brew behavior | `internal/brew/brew.go` | Parallel workers, StickyProgress for output, Uninstall/UninstallCask |
 | Add snapshot data | `internal/snapshot/capture.go` | Add to CaptureWithProgress steps |
+| Change snapshot restore | `internal/installer/installer.go` | stepRestoreGit, stepRestoreShell + packages/shell/macos |
 | Update self-update | `internal/updater/updater.go` | AutoUpgrade() called from root.go RunE |
 | Modify presets | `internal/config/data/presets.yaml` | 3 presets: minimal, developer, full |
 
@@ -64,6 +67,7 @@ cli (root)
 │   ├── shell (no deps)
 │   ├── system (no deps)
 │   └── ui → config, search, snapshot, system
+├── cleaner → brew, npm, snapshot, ui
 ├── updater → ui
 ├── auth → ui
 └── snapshot → config, macos

README.md

@@ -45,6 +45,8 @@ curl -fsSL openboot.dev/install.sh | bash
 - **macOS preferences** — Developer-friendly defaults (Dock, Finder, keyboard)
 - **Git identity** — Configure name and email during setup
 - **Smart installs** — Detects already-installed tools, skips them
+- **Clean up** — Remove packages not in your config with `openboot clean`
+- **Full snapshot restore** — Restores packages, git config, shell theme & plugins
 
 ## Web Dashboard
 
@@ -75,7 +77,20 @@ Already set up? Capture your environment and share it.
 openboot snapshot
 ```
 
-Captures Homebrew packages, macOS preferences, shell config, and git settings. Upload to [openboot.dev](https://openboot.dev) for a shareable install URL, or save locally with `--local`. [Learn more →](https://openboot.dev/docs/snapshot)
+Captures Homebrew packages, macOS preferences, shell config (Oh-My-Zsh theme & plugins), and git settings. Upload to [openboot.dev](https://openboot.dev) for a shareable install URL, or save locally with `--local`.
+
+Restoring from a snapshot now fully restores your environment — packages, git identity, shell theme, and plugins. [Learn more →](https://openboot.dev/docs/snapshot)
+
+### Clean
+
+Drifted from your config? Remove extra packages.
+
+```bash
+openboot clean                        # Compare against local snapshot
+openboot clean --user yourname        # Compare against cloud config
+openboot clean --from my-setup.json   # Compare against a snapshot file
+openboot clean --dry-run              # Preview what would be removed
+```
 
 ## For Teams
 
@@ -128,6 +143,7 @@ curl -fsSL openboot.dev/install.sh | bash -s -- --preset developer --silent
 ```bash
 openboot                 # Interactive setup
 openboot snapshot        # Capture your current setup
+openboot clean           # Remove packages not in your config
 openboot doctor          # Check system health
 openboot update          # Update Homebrew and packages
 openboot update --dry-run  # Preview updates

internal/snapshot/AGENTS.md

@@ -52,8 +52,21 @@ Each step is independent. Failures are non-fatal (captured as empty).
 }
 ```
 
+## RESTORE PIPELINE
+
+`snapshot --import` restores:
+1. Taps → `brew tap`
+2. Formulae/Casks → `brew install` (via installer.RunFromSnapshot)
+3. NPM packages → `npm install -g`
+4. Git config → `git config --global user.name/email` (skips if already set)
+5. Shell → Installs Oh-My-Zsh, sets ZSH_THEME and plugins in .zshrc
+6. macOS preferences → `defaults write`
+
+Snapshot data is mapped to `config.SnapshotGitConfig` and `config.SnapshotShellConfig` in `cli/snapshot.go`, then consumed by `installer.stepRestoreGit` and `installer.stepRestoreShell`.
+
 ## WHEN MODIFYING
 
 - Adding capture step: Add to `CaptureWithProgress()`, update `totalSteps`, add to `Snapshot` struct
+- Adding restore step: Add to `installer.RunFromSnapshot()`, create `config.Snapshot*Config` type, wire in `cli/snapshot.go`
 - Adding preset detection: Modify `DetectBestPreset()` scoring in `match.go`
 - Tests: Table-driven with testify. `capture_test.go` mocks command output. `match_test.go` tests Jaccard scoring.