chaff
Find and safely reclaim disk space and memory wasted by stale build artifacts, caches, and orphaned processes.
Free
Works with the AI Agents you already use
chaff
Example session with this skill installed
My disk is almost full and the machine is lagging. Check what's taking up space and give me a plan to clean up safely.
- Read your context and instructions
- Compiled the chaff
I have analyzed your system's resource usage. You currently have significant disk pressure from stale build caches and orphaned git worktrees. I have generated a reclamation plan categorized by risk level.
System Cleanup Plan (chaff_plan_8f2d)
| Target | Type | Size | Tier | Status |
|---|---|---|---|---|
~/code/old-project/node_modules | Stale Cache | 1.2 GB | Tier 1 (Dead) | Orphaned |
~/code/api/.git/worktrees/feature-x | Git Worktree | 850 MB | Tier 1 (Dead) | Merged |
~/.gradle/caches | Build Cache | 4.5 GB | Tier 2 (Idle) | Not used > 14 days |
NX Daemon (PID 49202) | Build Process | 400 MB | Tier 2 (Idle) | Inactive |
~/code/current-app/target | Build Output | 2.1 GB | Tier 3 (Live) | [Building] |
Summary:
- Tier 1 (Safe to reap): 2.05 GB can be reclaimed immediately.
- Tier 2 (Requires approval): 4.9 GB of caches/daemons can be cleared.
- Tier 3 (Skipped): 2.1 GB is currently locked by active processes.
Next steps
- Run
chaff_reapto clear the 2.05 GB of dead Tier 1 assets. - Review the idle Gradle caches; if you don't need them, I can run
chaff_clean --tier=2. - Use
chaff_worktrees --dirtyto verify no uncommitted code exists in the feature-x worktree.
Connects securely to your tools. The creator never sees your data.
About this skill
Developer machines accumulate gigabytes of dead weight that slow down builds and trigger disk space errors. This skill identifies and safely reclaims memory and disk space by targeting stray build daemons, stale caches, and abandoned worktrees without risking active work.
What it does
- Resource auditing identifies memory pressure and disk usage across local development environments.
- Tiered reclamation categorizes targets into dead assets (Tier 1), idle caches (Tier 2), and active work (Tier 3) to prevent accidental data loss.
- Build daemon management locates and terminates orphaned processes from Gradle, NX, or Node.js.
- Safe worktree pruning detects uncommitted changes in abandoned git worktrees before suggesting removal.
- Undoable operations moves files to a managed trash instead of immediate deletion, allowing for restoration.
How it works
- Assessment via
chaff_statusto determine current system pressure and identify specific bottlenecks. - Planning using
chaff_planto generate a list of targets and their associated tiers/sizes for user review. - Safety check with
chaff_worktreesto ensure no uncommitted code is lost in stale directories. - Execution of
chaff_reapfor dead assets orchaff_cleanfor idle caches after explicit user confirmation. - Verification by re-running status checks to report total reclaimed space and memory.
Frameworks & tools
Works with Node.js, Gradle, NX, git worktrees, and standard build daemons. Integrates via MCP, Claude Code plugins, or the @gulsahsarsilmaz/chaff CLI.
Why this beats prompting it yourself
Writing manual rm -rf commands or shell scripts risks deleting uncommitted work or active build artifacts. This skill uses a tiered safety system and built-in trash/restore functionality that basic file system prompts cannot replicate.
Use cases
- Fix ENOSPC "no space left on device" errors during large npm installs.
- Clean up orphaned tsserver or gradle processes causing system lag.
- Identify and remove forgotten git worktrees that duplicate heavy project caches.
- Recover disk space by clearing stale build outputs from inactive projects.
Known limitations
Tier 3 (live work) removal is disabled over MCP and requires manual CLI execution. Requires the chaff MCP server or CLI package to be available in the environment.
Tier 3 reclamation is restricted to CLI only. Requires @gulsahsarsilmaz/chaff package. Locked or building processes are skipped automatically.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
2 uses
Times used to date
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 1 month ago
- Free with an Agensi account
Requires