Watchdog daemon + 8-tool stdio MCP server.
An O(1) background watchdog detects low free space without burning disk I/O, asks your configured AI CLI (Agy, Pi, Codex, or Custom) for candidates, and exposes 8 typed MCP tools with hard human approval gates.
- OS-native daemon: launchd (macOS), systemd --user (Linux), zero-UAC Run key (Windows)
- AI proposals always open a standalone Confirm Cleanup dialog with Git dirty warnings
- Mutating MCP tools fail closed without desktop checkbox approval + OS Touch ID auth
{
"mcpServers": {
"ruum": {
"command": "ruum",
"args": ["mcp"]
}
}
}| Tool | Scope | Safety Boundary |
|---|---|---|
| list_volumes | Local / SSH | Read-only mount probe; zero file walk |
| scan_directory | Local / SSH | Read-only scan; cached in session |
| inspect_subtree | Local / SSH | Read-only tree lookup & substring search |
| find_reclaimable | Local / SSH | Heuristics: caches, build dirs, stale worktrees |
| check_git_safety | Local only | Hook-free Git status; rejects ssh_host |
| plan_removal | Local / SSH | Dry-run against safety guards; never deletes |
| trash_paths | Local / SSH | GUI Confirm Cleanup checkbox approval required |
| delete_permanently | Local only | GUI approval + OS native auth (Touch ID) |