Skip to content

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

Developer disk cleanup with a brain claude code command — WSL-aware, framework-aware, 3-lens safety council. npx storage-intelligence

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages