What problem does it solve?
When disk space runs critically low, normal assistant work is suspended and you need a safe, guided way to find what is consuming storage and free space without deleting important data.
Core Features & Use Cases
- Disk Usage Inspection: Runs bounded
df -h and du passes on the target volume or workspace to identify the largest directories before drilling deeper.
- Approval-Gated Cleanup: Presents each proposed deletion with exact path, estimated reclaimable size, and consequence, requiring explicit user approval before removing caches, logs, temp files, or Docker artifacts.
- Read-Only SQLite Diagnosis: Analyzes
data/db/assistant.db growth using read-only PRAGMA and SELECT queries to distinguish table growth from free-page bloat without mutating the database.
- Use Case: Your assistant locks into storage cleanup mode because the workspace volume is full. The skill inspects
/workspace, finds stale Docker artifacts and old logs, and walks you through approving each deletion until the disk-pressure lock clears.
Quick Start
Ask the assistant to inspect what is using disk space in the workspace and propose safe cleanup steps to free storage.
