| name | predictive-resources |
| description | Predict resource exhaustion (disk, memory, swap) using trend analysis. Proactively alert and propose NixOS config fixes before things break.
|
| tools | ["system_health","shell_exec","memory_store","memory_recall","file_read","file_write","teach_patterns","teach_observations"] |
| activation | auto |
Predictive Resource Exhaustion
Don't wait for things to break. Predict when they will and fix proactively.
teachd Trend Data
Before collecting your own data points, check teachd — it has been observing CPU, memory, and services every 30 seconds since boot:
teach_patterns({ type: "trend", min_confidence: 0.3 })
teach_observations({ source: "memory", limit: 100 })
teachd automatically detects monotonic memory increases over 6+ data points. If it has already flagged a trend, use that instead of re-deriving manually.
Disk Growth Analysis
Collect data points over time and project forward:
shell_exec({ command: "df -h --output=target,used,avail,pcent / /var /nix/store /tmp 2>/dev/null || df -h" })
Track in memory — store periodic snapshots:
memory_store({
summary: "Disk snapshot: / 38% used, /nix/store 12GB",
detail: "Full df output...",
category: "system.config",
tags: "disk,snapshot,predictive"
})
When you have 2+ data points, calculate growth rate:
- Growth per day = (current_used - previous_used) / days_between
- Days until 95% = (capacity * 0.95 - current_used) / growth_per_day
Thresholds & Alerts
| Metric | Warning | Critical | Action |
|---|
| Disk fills in < 7 days | Alert user | Auto-clean | nix-collect-garbage, logrotate |
| Memory avg > 80% for 1hr | Alert user | OOM risk | Identify top consumers |
| Swap usage growing | Monitor | > 50% used | Recommend more RAM or optimize |
| /nix/store > 30GB | Suggest cleanup | > 50GB | Auto-GC old generations |
Remediation (NixOS-native)
Disk: Nix garbage collection
shell_exec({ command: "nix-collect-garbage --delete-older-than 14d" })
Disk: Log rotation via NixOS config
Propose adding to configuration.nix:
services.journald.extraConfig = "SystemMaxUse=500M";
Memory: Identify and advise
shell_exec({ command: "ps aux --sort=-%mem | head -15" })
Don't kill processes without permission. Advise the user.
Swap: NixOS swap config
swapDevices = [{ device = "/swapfile"; size = 4096; }];
User Preference Learning
After each alert, remember what the user chose:
memory_store({
summary: "User prefers automatic log cleanup when disk > 80%",
detail: "Approved automatic journalctl vacuum and nix-collect-garbage",
category: "user_pattern",
tags: "preference,disk,auto-remediation"
})
Next time, check memory before asking:
memory_recall({ query: "user preference disk cleanup auto" })
If they previously approved auto-remediation, do it and just notify.
