storage-intelligence

Developer disk cleanup with a brain. WSL-aware, framework-aware, safe.

A 3-lens safety council classifies every item before anything is touched. Stale WSL swap files, .next build caches, old CLI versions — auto-cleaned. Package manager caches, inactive projects — your call.

npx storage-intelligence

Why This Exists

Standard disk cleanup tools don't know about WSL, don't understand .next caches, and don't distinguish between "safe to delete" and "this will break your project." This one does.

The #1 developer space waster nobody talks about: stale WSL swap.vhdx files. Every WSL session restart can leave a multi-GB orphan virtual memory file in Windows Temp. 5 restarts = 15-30 GB gone silently. This tool detects and removes them automatically.

Install & Use

# One-shot (no install)
npx storage-intelligence

# Install globally
npm install -g storage-intelligence
storage-intelligence        # or: si

# Modes
npx storage-intelligence scan    # dry run — report only, no deletions
npx storage-intelligence purge   # auto-clean only, no questions
npx storage-intelligence deep    # include inactive project node_modules

What Gets Cleaned

Auto-cleaned (no confirmation needed)

| Item | Why Safe | |------|----------| | Stale WSL swap.vhdx files | Orphaned from old sessions — today's is preserved | | .next / .nuxt / .turbo / .svelte-kit build caches | Regenerated in seconds on next build | | DiagOutputDir, Diagnostics, wsl-crashes in Temp | Debug artifacts, no functional value | | pip-unpack-* temp directories | Failed pip install leftovers | | OpenCode logs and snapshots | Debug artifacts | | Old Claude CLI versions | Only the latest version is needed |

Recommended (you choose)

| Item | Notes | |------|-------| | npm / pnpm / uv / pip caches | 100% re-downloadable, next install auto-regenerates | | Stale Playwright / Puppeteer binaries | Re-downloads on next test run | | Old global npm packages with no project references | | | node_modules in projects with no git activity in 30+ days | |

Always preserved

• Today's WSL swap file (active session)
• .worktrees, .git directories
• User data (Documents, Pictures, Videos, Desktop)
• Credentials and secrets
• Items under 50MB (not worth the risk)

The 3-Lens Council

Every item passes three independent reviewers before a verdict is issued:

Safety Guardian      — "Could deleting this break anything running right now?"
Efficiency Analyst   — "Is the size-to-risk ratio worth it?"
Developer Advocate   — "Does the dev workflow actually need this?"

All three must approve before an item is auto-deleted. Any single veto → PRESERVE.

Claude Code Integration

If you use Claude Code, the AI-powered version is available as a slash command:

# Copy to your project's .claude/commands/
cp node_modules/storage-intelligence/claude-commands/storage-intelligence.md .claude/commands/

Then in Claude Code: /storage-intelligence

The Claude Code version uses AI reasoning for edge cases the heuristic version handles with hardcoded rules.

ACOS Plugin

If you use the Agentic Creator OS, storage-intelligence is included in the dev-tools plugin:

claude plugin install dev-tools

Post-Cleanup (WSL Users)

After cleanup, compact the WSL virtual disk to reclaim the freed space on C: drive:

# Run from Windows PowerShell (Admin)
wsl --shutdown
wsl --manage Ubuntu-24.04 --optimize

This converts the freed space back to available C: drive space.

Requirements

• Node.js 18+
• Works on: WSL (recommended), Linux, macOS
• Windows (native): partial support — WSL-specific zones are skipped

License

MIT — frankx.ai