Reclaim your disk space in one command. A cross-platform disk analyzer and cleanup tool that scans for space hogs, shows you exactly what's eating your storage, and cleans up with your approval. No bloatware, no surprises, no silent deletions.
Works on Windows 10/11, macOS 12+, and Linux (Ubuntu, Fedora, Arch, Debian).
Every developer's machine accumulates junk over time: stale node_modules in forgotten projects, 6 GB of npm cache, orphaned Electron updater folders, registry entries pointing to apps you uninstalled months ago. You know it's there, but tracking it all down manually takes hours.
PC Freespace does the detective work for you. It scans 7 categories, shows you a clear summary, and lets you decide what goes. Nothing is deleted without your explicit approval.
# From the plugin marketplace
/install-plugin pc-freespace
# From GitHub
claude plugins install gh:usman101/pc-freespace
# Local development
claude plugins add /path/to/pc-freespace/pc-freespace
That's it. The interactive flow handles the rest.
/pc-freespace
=== PC Freespace ===
OS: Windows 11
Drive: C:
Total: 217.4 GB
Free: 13.0 GB (6%)
Status: Critical
Scanning 7 categories...
# Category Found Est. Recovery
---------------------------------------------------------
1 Package caches 8 items 12.4 GB
2 Temp files & logs 15 items 2.8 GB
3 Dev tool artifacts 6 items 7.2 GB
4 App caches & updaters 9 items 3.1 GB
5 Old downloads 4 items 1.2 GB
6 Dormant dot-folders 3 items 1.8 GB
7 Registry/system orphans 11 items -- (metadata)
---------------------------------------------------------
Total potential: 28.5 GB
Drive would go from 94% used -> 81% used
Which categories do you want to clean? (all / 1,3,4 / skip)
| # | Category | What it finds |
|---|---|---|
| 1 | Package caches | npm, pip, pnpm, uv, cargo, brew, gradle, maven, yarn, bun, composer, nuget, cocoapods, go modules |
| 2 | Temp & logs | OS temp directories, crash dumps, old log files, error reports |
| 3 | Dev tool artifacts | node_modules, .venv, Playwright browsers, build output dirs (dist, .next, target) |
| 4 | App caches & updaters | Orphaned Electron updater folders, stale app data for uninstalled apps |
| 5 | Old downloads | Installer files (.exe, .dmg, .deb) older than 30 days, old archives |
| 6 | Dormant dot-folders | Config folders for tools you no longer have installed |
| 7 | Registry / system metadata | Orphaned uninstall entries (Win), stale plist files (Mac), dead .desktop files & broken symlinks (Linux) |
This tool was designed by someone who lost data to aggressive cleaners before. Every design decision prioritizes safety:
- Nothing is deleted without your approval -- every item is listed and you confirm before deletion
- Auto-protects critical data -- browsers, git repos, SSH keys, credentials, running apps
- Registry backups -- exports
.regbackup files before any registry modification (Windows) - Locked files skipped -- files in use are silently skipped and reported at the end
- Admin-only items surfaced, never executed -- pagefile, hibernate, WinSxS, Time Machine, old kernels are reported as suggestions only
| Category | Examples |
|---|---|
| Browser data | Chrome, Firefox, Brave, Edge, Opera, Safari, Arc, Vivaldi |
| Credentials | .ssh, .gnupg, .aws, .azure, .gcloud |
| Git repos | Any directory containing .git |
| Active tools | .config, .local, .vscode, .nvm, .pyenv, .rustup |
| Running apps | Anything matching a currently running process |
| User documents | PDFs, images, videos, spreadsheets in Downloads |
Some optimizations require elevated privileges. PC Freespace detects and reports these at the end of every scan without trying to execute them:
| Platform | Suggestion |
|---|---|
| Windows | Pagefile resize/relocation, hibernate reduction, WinSxS cleanup, Windows Update cache |
| macOS | Time Machine local snapshots, Xcode simulator cleanup |
| Linux | Old kernel removal, snap/flatpak unused runtimes, journal log vacuuming |
| Platform | Status |
|---|---|
| Windows 10 | Supported |
| Windows 11 | Supported |
| macOS 12+ (Monterey) | Supported |
| Ubuntu 20.04+ | Supported |
| Fedora 36+ | Supported |
| Debian 11+ | Supported |
| Arch Linux | Supported |
pc-freespace/
.claude-plugin/
plugin.json # Plugin manifest
commands/
pc-freespace.md # /pc-freespace command trigger
skills/
disk-cleanup/
SKILL.md # Core 5-phase workflow
references/
scan-targets.md # Platform-specific paths and commands
README.md
LICENSE
Found a cache directory we're not scanning? Know a common space hog on your OS?
- Fork the repo
- Add entries to
skills/disk-cleanup/references/scan-targets.mdunder the appropriate platform section - Submit a PR
The scan-targets.md file is designed to be community-extensible -- each entry is a simple table row with path, safety info, and recreation notes.
MIT -- see LICENSE for details.