Ballast
From its catalog listing
Free a target amount of disk space by clearing the developer and AI caches you'll miss least, with Hermes approval and rebuild recipes.
Good to know before installing
after a Hermes approval prompt, `ballast_apply` permanently deletes (no Trash) the contents of cataloged cache directories under your home (npm, pnpm, Yarn, pip, uv, Cargo, Homebrew downloads, Xcode DerivedData/device support, CoreSimulator caches, HuggingFace hub, Gradle, CocoaPods, Go; Ollama and LM Studio model stores only on explicit opt-in). Runs your locally installed npm/yarn/pip/uv/go cache cleaners (argv, no shell, minimal offline environment) and read-only `docker system df`. No network, no credentials read; state in plugin-data/ballast/. Cron and unattended runs are refused.
From its catalog listing.
How to install
- Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
hermes plugins install ballast - Said no? Turn it on later:
hermes plugins enable ballast - Restart Hermes so it loads the plugin.
Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).
- Category
- Security & privacy
- Maintained by
- 1momoh (Community)
- Needs
- No API keys declared
- Adds tools
ballast_scanballast_planballast_applyballast_ledgerballast_status- Adds hooks
pre_tool_callpre_approval_requestpost_approval_response- Works on
- macos
- Needs Hermes
- 0.23.0 or newer
- Version
- 0.1.0
- In the catalog
- 2026-11-10
Using the Hermes desktop app? See where plugins live

Full setup & settings ↗Source code ↗
More in security & privacy
All security & privacy plugins
New Hermes Agent updates every day on X. Follow @HermesWatcher