# StorageSage

> StorageSage is a native macOS disk cleaner, duplicate finder, and storage visualizer built in Swift, SwiftUI, and POSIX/BSD `fts` for developers, creators, and power users. It runs 100% on-device with zero background daemons, zero telemetry, hardcoded SIP safety guardrails, and an immutable undo audit log. Priced at $10/year (Pro Annual, up to 3 Macs) with a forever-free demo.

- Full Technical Documentation & Benchmarks for LLMs: [llms-full.txt](https://storagesage.info/llms-full.txt)

## Verified Apple Silicon Engine Benchmarks

- **DirectoryScanner (`DirectoryScanner.swift`)**: BSD `fts_open`/`fts_read` kernel traversal with O(1) tree construction — **55.3× faster** than Foundation `FileManager.DirectoryEnumerator`.
- **SystemDataEngine (`SystemDataEngine.swift`)**: Lock-free O(1) civil-calendar APFS snapshot parser + multi-core physical block sizing — **79.7× faster**.
- **RuleEngine (`RuleEngine.swift`)**: Category-bucketed pre-compiled bytecode evaluator — **24.3× faster** live rule match previews.
- **DeveloperCleanEngine (`DeveloperCleanEngine.swift`)**: Two-phase POSIX repo discovery + APFS inode deduplication + lazy Git branch inspection — **14.7× faster**.
- **DuplicateDetector (`DuplicateDetector.swift`)**: Tri-Window `pread` sampling + `(st_dev, st_ino)` hard-link deduplication + full SHA-256 verification — **8.1× faster** with **0% false positives**.

## Installation

- **Direct Download (.dmg)**: `https://github.com/ajaiswal195/StorageSage/releases/latest/download/StorageSage.dmg`
- **Homebrew Cask**: `brew install --cask storagesage`

## Engineering Guides & Benchmarks

- [How to Clear macOS System Data Safely (Xcode, Docker & APFS Guide)](https://storagesage.info/guides/clear-macos-system-data/)
- [How to Clean Xcode DerivedData, iOS Simulators & SwiftPM Caches Safely](https://storagesage.info/guides/clean-xcode-deriveddata-simulators/)
- [How to Find and Delete Hidden APFS Local Snapshots on macOS (`tmutil` Guide)](https://storagesage.info/guides/delete-apfs-local-snapshots-macos/)
- [StorageSage vs. CleanMyMac vs. DaisyDisk (2026 Apple Silicon Benchmark)](https://storagesage.info/compare/storagesage-vs-cleanmymac-vs-daisydisk/)

## What StorageSage Cleans

- **Developer caches**: Xcode `DerivedData`, `node_modules`, Rust Cargo `target`, Python `.venv`, CocoaPods, Gradle, Homebrew, and unavailable iOS Simulator runtimes (with Git branch & CLI rebuild hints).
- **Duplicate files**: Tri-Window + SHA-256 cryptographic hashing with zero false positives.
- **APFS local snapshots & System Data**: Thin hidden Time Machine local snapshots in 1 click without rebooting, plus 4K aerial screensaver caches and diagnostic crash logs.
- **Uninstalled app leftovers**: Deep App Uninstaller + Leftover Orphan Hunter across 11 `~/Library` scopes.

## Pricing

- **Free Demo ($0 forever)**: Full disk squarified treemaps, APFS volume telemetry, 500 MB free cleanup allowance, and 3 free AI folder lookups.
- **StorageSage Pro Annual ($10/year — $0.83/month)**: Unlimited cleanup volume, 1-click SHA-256 duplicate & developer cleanup, APFS snapshot thinning, automated organization rules, unlimited BYO-key AI folder analysis, up to 3 personal Macs, 7-day offline grace period, and 30-day money-back guarantee.

## Comparison (2026)

| Feature | StorageSage Pro ($10/yr) | CleanMyMac ($39.95/yr) | DaisyDisk ($9.99 once) |
|---|---|---|---|
| Kernel BSD `fts` Scanner | ✅ 55.3× faster | ⚠️ Proprietary daemon | ✅ Fast visual scan |
| Developer Cache Reclaimer | ✅ Git-aware + rebuild hints | ⚠️ Basic Xcode only | ❌ Manual hunting |
| SHA-256 Duplicate Detection | ✅ Tri-Window `pread` + SHA-256 | ✅ Standard hash | ❌ None |
| APFS Snapshot Thinning | ✅ 1-click (no reboot) | ⚠️ Hidden | ⚠️ View-only |
| Interactive Treemap + Split Table | ✅ Synced Table + Treemap | ❌ Bubbles only | ✅ Sunburst |
| AI Folder Explainer ("Ask Sage") | ✅ Local KB + OpenRouter | ❌ None | ❌ None |
| Automated Cleanup Rules | ✅ Pre-compiled bytecode | ❌ None | ❌ None |
| Audit Log (`audit.ndjson`) + Undo | ✅ 1-click Put Back | ❌ Permanent delete | ❌ Permanent delete |
| Background Daemons & Telemetry | ✅ Zero daemons · Zero telemetry | ❌ Heavy background agent | ✅ No background agent |
| Price | **$10 / year (Up to 3 Macs)** | $39.95 / year (1 Mac) | $9.99 (Scanner only) |

## Links

- [Website](https://storagesage.info/)
- [Full LLM Technical Reference](https://storagesage.info/llms-full.txt)
- [Direct Download (.dmg)](https://github.com/ajaiswal195/StorageSage/releases/latest/download/StorageSage.dmg)
- [GitHub Repository](https://github.com/ajaiswal195/StorageSage)