StorageSaver Watcher is a read-only Mac disk scanner and monitoring utility that visualizes storage usage through an interactive HTML sunburst chart and provides plain-English safety assessments.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install storagesaver
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install storagesaver using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is StorageSaver Watcher?
StorageSaver is designed to address Mac disk space issues without compromising system safety. By functioning strictly as a read-only analysis tool, it scans the file system to produce an interactive HTML map containing sunburst and tree visualizations. Instead of executing destructive actions, the utility displays easy-win recommendations alongside copy-paste commands, keeping the operator in complete control.
When integrated into automation workflows or used alongside Openclaw Skills, this tool acts as an active disk sentinel. It uses a smart watcher script to run scheduled checks, evaluate current usage against progressive severity tiers, and issue debounced notifications only when actionable limits are reached.
StorageSaver Watcher Use Cases
- Diagnostic assessment when Mac storage becomes full or tight.
- Generating visual maps of disk usage to spot large, forgotten directories.
- Scheduled, low-noise disk space monitoring with custom notification routing.
- Non-destructive analysis of unused applications using real application activity and OS signals.
How StorageSaver Watcher Works
- Disk Scanning: Run a swift or full-system scan to walk the directory structure and evaluate file sizes.
- Visual Mapping: Generate an interactive HTML map detailing file hierarchy, safety badges, and actionable reclamation commands.
- Severity Tiering: Evaluate disk volume capacity across silent (<70%), warning (70–84%), critical (85–94%), and urgent (>=95%) states.
- Debounced Reporting: Check the status against historical logs to avoid repeating notifications within a six-day window.
- Notification Dispatch: Route alerts via shell commands to specified channels like email, chat webhooks, or local output, attaching the interactive HTML map.
StorageSaver Watcher Setup
To perform a one-off scan, run the utility via npx:
# Run a full scan and open the interactive map in your browser
npx storagesaver
# Run a fast pass on your home folder only
npx storagesaver --quick
For scheduled watching, install the package globally:
npm install -g storagesaver
Set up a periodic schedule using crontab:
0 10 * * 1 NOTIFY_CMD='mail -s "Mac storage" [email protected]' node /path/to/skill/watcher.js
To integrate with Openclaw Skills, schedule the watcher directly through your agent:
openclaw cron add --name storage-watch --schedule "0 10 * * 1" \
--command "node /path/to/StorageSaver/skill/watcher.js" \
--deliver
StorageSaver Watcher Data Schema & Taxonomy
StorageSaver keeps state files, execution logs, and custom rules separated from system files. The directory structure is organized as follows:
| Path | Type | Description |
|---|---|---|
~/.config/storagesaver/ |
Directory | Root configuration directory for state management. |
~/.config/storagesaver/rules.json |
JSON | User-defined custom rules and path exclusions. |
/tmp/storagesaver.html |
HTML | Output target for non-opening scans, holding interactive visualization data. |
Application Verification Signals
To evaluate whether applications are truly unused, the tool cross-checks multiple system coordinates rather than relying solely on file modification timestamps:
- Process Matching: Checks active execution by querying process paths via
pgrep -f. - Login Item Registry: Evaluates macOS system properties via AppleScript to confirm auto-launch configurations.
- Metadata Evaluation: Reads Spotlight metadata (
kMDItemLastUsedDate) to verify actual application interactions.
StorageSaver Watcher Advanced Features
- Debounced Alert Engine: Minimizes notification fatigue by suppressing warnings of the same severity tier for up to 6 days.
- Non-Destructive Playbook: Follows safe verification protocols for cloud-synced folders (e.g., iCloud, Google Drive) and managed libraries (e.g., Photos, Docker images) to prevent accidental deletions.
- Custom Notification Routing: Connects alert outputs to external services by passing parameters through a flexible
NOTIFY_CMDenvironment variable. - User-Defined Exclusions: Employs customizable safety profiles through local JSON rules, overriding default scanning configurations.
SKILL.md
Loading
Related Openclaw Skills
AI Open Source Tech Due Diligence
An Openclaw Skills pipeline that turns GitHub Trending discoveries into deep technical due diligence, WeChat-ready articles, and Feishu knowledge-base docs.
TRPG Abbreviation Wrapper
An idempotent automation tool to safely wrap TRPG rule abbreviations into readable Chinese-English paired formats across Markdown, text, and Excel files.
TRPG Abbreviation Check and Formatting Rules
An automated auditing tool to scan and convert English abbreviations into standardized Chinese terms within TRPG rules and scenarios.
TRPG Numeric Balance Audit
Openclaw Skills for auditing TRPG rule numbers, simulating play scenarios to catch broken progression, economy, combat, and gear balance.
AI Music Composer
A professional end-to-end AI music generator that clones your voice and composes complete, personalized songs based on your lyrics and style preferences.
Open Source Issue-First Workflow
An Openclaw Skills workflow that forces you to search upstream issues and releases before writing custom workarounds for open-source bugs.
Featured*
