Skip to content

guider23/Zoop

Repository files navigation

image

Disk space management for Windows that understands your projects.

❤️ Sponsors

YouMind TRACTIAN LobeHub

Platform License Version Built with Tauri

Zoop-ai scans your drives, identifies regenerable build artifacts (node_modules, target/, .venv, __pycache__, and more), and removes them safely — routing everything through the Windows Recycle Bin so nothing is permanently gone. An optional Claude API integration explains the risk of anything it finds before you act.


Download v1

Pre-built installers for Windows 10 and 11 are available on the Releases page.


Features

  • Project-aware scanning — Understands the directory structure of Node, Rust, Python, and other ecosystems. Associates artifacts with their parent project before flagging them for removal.
  • Interactive treemap — Visual breakdown of where your disk space actually is. Built with D3.
  • AI risk analysis — Optional. Feed a path to Claude and get a plain-English explanation of what it is and whether deleting it matters. The hardcoded safety rules always take precedence.
  • Five-gate deletion pipeline — Path verification, protected-path enforcement, recency check, manifest recording, and Recycle Bin routing — in that order, every time.
  • Pre-deletion manifests — JSON record of every item removed, stored locally and viewable from the Logs page.
  • System tray — Background scanning on a schedule. Notifies you when reclaimable space crosses a threshold you set.

Safety

Zoop-ai does not permanently delete files. All removals use the Windows Shell API with FOFX_RECYCLEONDELETE. Everything is recoverable from the Recycle Bin.

The following are never touched regardless of settings:

  • Desktop, Documents, Downloads, Pictures, Videos, Music
  • Any path containing .git
  • Windows system directories and Program Files

If AI analysis is enabled, it can flag an item as higher risk — but it cannot override the hardcoded protected-path list or lower a risk classification below its baseline.


Building from source

Requirements: Node.js 18+, Rust 1.70+ (rustup), Windows 10/11

git clone https://github.com/yourusername/zoop-ai.git
cd zoop-ai
npm install
npm run tauri:dev      # development
npm run tauri:build    # production — output in src-tauri/target/release/bundle/
npm test               # frontend tests
cd src-tauri && cargo test  # backend tests

AI setup

The app works fully without AI. To enable it:

  1. Get an API key at console.anthropic.com.
  2. Open Settings → AI Configuration.
  3. Paste your key and toggle Enable AI Analysis.

Only filenames and immediate parent directory names are sent to the API — never full paths.


Stack

Framework Tauri 2.0
Backend Rust · Tokio · Serde · Windows API
Frontend React 18 · TypeScript · Zustand · Tailwind CSS
Visualization D3.js
AI Anthropic Claude API (optional)

Contributing

Open your Security issues → security@bcworks.com (not a public issue).

@guider23 @Fuckies


License

MIT

About

Disk space management for Windows that understands your projects.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors