wehub-resource-sync
b4fbd6fe9f
Deploy Site / deploy-vercel (push) Has been skipped
Deploy Site / deploy-docs (push) Has been skipped
Build Skills Index / build-index (push) Has been skipped
CI / Deny unrelated histories (push) Has been skipped
CI / Detect affected areas (push) Successful in 27m35s
CI / OSV scan (push) Failing after 4s
CI / Build&Test Docker image (push) Successful in 9s
CI / Supply-chain scan (push) Has been skipped
CI / Lint Docker scripts (push) Failing after 5m13s
CI / Check contributors (push) Failing after 12m8s
CI / Docs Site (push) Failing after 12m8s
CI / TypeScript (push) Failing after 12m8s
CI / Python lints (push) Failing after 12m9s
CI / Python tests (push) Failing after 12m9s
CI / Check uv.lock (push) Failing after 23m22s
CI / CI timing report (push) Has been cancelled
Build Skills Index / trigger-deploy (push) Has been cancelled
CI / All required checks pass (push) Has been cancelled
52 lines
2.1 KiB
Markdown
52 lines
2.1 KiB
Markdown
# disk-cleanup
|
|
|
|
Auto-tracks and cleans up ephemeral files created during Hermes Agent
|
|
sessions — test scripts, temp outputs, cron logs, stale chrome profiles.
|
|
Scoped strictly to `$HERMES_HOME` and `/tmp/hermes-*`.
|
|
|
|
Originally contributed by [@LVT382009](https://github.com/LVT382009) as a
|
|
skill in PR #12212. Ported to the plugin system so the behaviour runs
|
|
automatically via `post_tool_call` and `on_session_end` hooks — the agent
|
|
never needs to remember to call a tool.
|
|
|
|
## How it works
|
|
|
|
| Hook | Behaviour |
|
|
|---|---|
|
|
| `post_tool_call` | When `write_file` / `terminal` / `patch` creates a file matching `test_*`, `tmp_*`, or `*.test.*` inside `HERMES_HOME`, track it silently as `test` / `temp` / `cron-output`. |
|
|
| `on_session_end` | If any test files were auto-tracked during this turn, run `quick` cleanup (no prompts). |
|
|
|
|
Deletion rules (same as the original PR):
|
|
|
|
| Category | Threshold | Confirmation |
|
|
|---|---|---|
|
|
| `test` | every session end | Never |
|
|
| `temp` | >7 days since tracked | Never |
|
|
| `cron-output` | >14 days since tracked | Never |
|
|
| empty dirs under HERMES_HOME | always | Never |
|
|
| `research` | >30 days, beyond 10 newest | Always (deep only) |
|
|
| `chrome-profile` | >14 days since tracked | Always (deep only) |
|
|
| files >500 MB | never auto | Always (deep only) |
|
|
|
|
## Slash command
|
|
|
|
```
|
|
/disk-cleanup status # breakdown + top-10 largest
|
|
/disk-cleanup dry-run # preview without deleting
|
|
/disk-cleanup quick # run safe cleanup now
|
|
/disk-cleanup deep # quick + list items needing prompt
|
|
/disk-cleanup track <path> <category> # manual tracking
|
|
/disk-cleanup forget <path> # stop tracking
|
|
```
|
|
|
|
## Safety
|
|
|
|
- `is_safe_path()` rejects anything outside `HERMES_HOME` or `/tmp/hermes-*`
|
|
- Windows mounts (`/mnt/c` etc.) are rejected
|
|
- The state directory `$HERMES_HOME/disk-cleanup/` is itself excluded
|
|
- `$HERMES_HOME/logs/`, `memories/`, `sessions/`, `skills/`, `plugins/`,
|
|
and config files are never tracked
|
|
- Backup/restore is scoped to `tracked.json` — the plugin never touches
|
|
agent logs
|
|
- Atomic writes: `.tmp` → backup → rename
|