← Back to Skills Marketplace
theshadowrose

Disk Watch

by Shadow Rose · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ✓ Security Clean
400
Downloads
0
Stars
2
Active Installs
3
Versions
Install in OpenClaw
/install disk-watch
Description
Monitor disk space across drives. Alert before disks fill up. Track usage trends, find space hogs, suggest cleanup. Every server needs this.
README (SKILL.md)

DiskWatch Disk Space Monitor & Alert

Monitor disk space across drives. Alert before disks fill up. Track usage trends, find space hogs, suggest cleanup. Every server needs this.


Get alerted before your disk fills up. Find what's eating space.

Usage

const { DiskWatch } = require('./src/disk-watch');
const watch = new DiskWatch({
  warningThreshold: 80,
  criticalThreshold: 90,
  checkInterval: 3600000  // hourly
});
watch.start();

Output

💾 Disk Status

C: 234/500 GB (47%) ✅
D: 890/1000 GB (89%) ⚠️ WARNING
E: 58/64 GB (91%) 🔴 CRITICAL

Top consumers (D:):
  1. /data/backups/  312 GB (35%)
  2. /data/logs/     198 GB (22%)
  3. /data/models/   145 GB (16%)

Suggestion: backups/ has 187 GB reclaimable (>90 days old)

Features

  • Multi-drive monitoring — all mounted drives
  • Threshold alerts — warning and critical levels
  • Space hog detection — largest directories
  • Trend tracking — "Disk growing 2 GB/day"
  • Cleanup suggestions — old files, duplicates
  • Cross-platform — Windows, Linux, macOS

⚠️ Disclaimer

This software is provided "AS IS", without warranty of any kind, express or implied.

USE AT YOUR OWN RISK.

  • The author(s) are NOT liable for any damages, losses, or consequences arising from the use or misuse of this software — including but not limited to financial loss, data loss, security breaches, business interruption, or any indirect/consequential damages.
  • This software does NOT constitute financial, legal, trading, or professional advice.
  • Users are solely responsible for evaluating whether this software is suitable for their use case, environment, and risk tolerance.
  • No guarantee is made regarding accuracy, reliability, completeness, or fitness for any particular purpose.
  • The author(s) are not responsible for how third parties use, modify, or distribute this software after purchase.

By downloading, installing, or using this software, you acknowledge that you have read this disclaimer and agree to use the software entirely at your own risk.

DATA DISCLAIMER: This software processes and stores data locally on your system. The author(s) are not responsible for data loss, corruption, or unauthorized access resulting from software bugs, system failures, or user error. Always maintain independent backups of important data. This software does not transmit data externally unless explicitly configured by the user.


Support & Links

🐛 Bug Reports [email protected]
Ko-fi ko-fi.com/theshadowrose
🛒 Gumroad shadowyrose.gumroad.com
🐦 Twitter @TheShadowyRose
🐙 GitHub github.com/TheShadowRose
🧠 PromptBase promptbase.com/profile/shadowrose

Built with OpenClaw — thank you for making this possible.


🛠️ Need something custom? Custom OpenClaw agents & skills starting at $500. If you can describe it, I can build it. → Hire me on Fiverr

Usage Guidance
This skill appears to do what it says: run local disk-usage commands, scan directories up to a shallow depth, and store a small JSON history in the system temp folder. Before installing, consider: run it with a non-privileged account (it will read filesystem metadata and execute df/wmic), review or test the code in a safe environment, and be cautious about calling findHogs on sensitive system paths (it will traverse directories you pass it). Also note there is no upstream homepage or verified publisher information — if provenance matters, verify the author or run inside a container/isolated VM.
Capability Analysis
Type: OpenClaw Skill Name: disk-watch Version: 1.0.2 The DiskWatch skill bundle is a legitimate utility for monitoring disk space and identifying large directories. The code in src/disk-watch.js uses standard Node.js modules (fs, child_process, os) to execute system commands like 'wmic' (Windows) and 'df' (Unix) to gather storage metrics. While it uses execSync with string interpolation, it includes regex validation for drive inputs on Windows to prevent command injection, and its behavior aligns perfectly with the stated purpose in SKILL.md without any signs of data exfiltration or malicious intent.
Capability Assessment
Purpose & Capability
Name/description match the included code: DiskWatch inspects mounted drives, runs platform-specific disk commands (df/wmic), scans directories for largest consumers, and stores a local history. There are no unrelated credentials, network calls, or external services requested.
Instruction Scope
SKILL.md describes local disk monitoring and the code follows that scope. The runtime instructions and API examples do not request unrelated files or credentials. The implementation reads directories, executes df/wmic, and writes a local history file — all consistent with the stated features.
Install Mechanism
No install spec or external downloads are present. The skill is instruction-only in the registry (though it includes source files); nothing is fetched or extracted from remote URLs during install.
Credentials
The skill declares no required environment variables or credentials and the code does not read env vars. It only uses local filesystem and OS commands, which are proportionate to disk-monitoring functionality.
Persistence & Privilege
The skill is not forced-always, does not modify other skills, and only writes a local history file under the system temp directory. That limited local persistence is appropriate for trend tracking.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install disk-watch
  3. After installation, invoke the skill by name or use /disk-watch
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Removed the incorrect character "�" from the skill name and title. - Updated the version number in SKILL.md to 1.0.2.
v1.0.1
- Version updated to 1.0.1. - Documentation (SKILL.md) updated to reflect new version number.
v1.0.0
Initial upload
Metadata
Slug disk-watch
Version 1.0.2
License MIT-0
All-time Installs 2
Active Installs 2
Total Versions 3
Frequently Asked Questions

What is Disk Watch?

Monitor disk space across drives. Alert before disks fill up. Track usage trends, find space hogs, suggest cleanup. Every server needs this. It is an AI Agent Skill for Claude Code / OpenClaw, with 400 downloads so far.

How do I install Disk Watch?

Run "/install disk-watch" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Disk Watch free?

Yes, Disk Watch is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Disk Watch support?

Disk Watch is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Disk Watch?

It is built and maintained by Shadow Rose (@theshadowrose); the current version is v1.0.2.

💬 Comments