# Disk Usage Watcher

> Disk Usage Watcher

- Skill: `javimosch/disk-usage-watcher` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/disk-usage-watcher`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/disk-usage-watcher/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/disk-usage-watcher

---

# Disk Usage Watcher

## Description
Monitors disk space and inode usage on specified paths, sending alerts when thresholds are exceeded. Essential for preventing disk-full incidents.

## Usage
The agent can call this skill directly or it runs automatically via cron every 15 minutes.

### Example Prompts:
- "Check disk space on root partition"
- "Monitor all mount points and alert at 85%"
- "Show me disk usage statistics"

## Inputs
- `threshold_percent`: number — Alert when usage exceeds this percentage (default: 85)
- `inode_threshold`: number — Alert when inode usage exceeds this percentage (default: 85)
- `paths`: array — Specific paths to monitor (default: all mounted partitions)
- `alert_on_failure`: boolean — Send alert if check fails (default: true)

## Outputs
- `status`: string — "success" or "failure"
- `details`: object — Contains disk_usage array with mount points, usage percentages, and any triggered alerts

## Dependencies
- `openclaw/exec` - For running df commands
- `openclaw/notify` - For sending alerts

## Testing
```bash
openclaw call disk-usage-watcher --params '{"paths": ["/"]}'
```