storage_ballast_helper
Daemon that monitors disk pressure and safely reclaims space for AI coding workloads.
Tested on Linux
Use it
Linux x86_64
Download installer script for reading
curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/storage_ballast_helper/main/scripts/install.sh -o /tmp/install_sbh.shRun installer script user install
bash /tmp/install_sbh.sh && ~/.local/bin/sbh --version
Where the README and reality differ
- README: ./target/release/sbh --help
What worked: sbh is at ~/.local/bin/sbh; used sbh --help and sbh status/check/scan/ballast/emergency
Check that it works
sbh --helpThe output should contain “Show current health and pressure status”.
First thing to try
sbh status --jsonRun sbh status --json to see the current disk pressure and ballast pool state.
What it does
- Monitor disk pressure and predict when it fillsTested
How to use it
- Run
sbh status --jsonto see overall pressure, ballast pool health and daemon state.
- Run
- Free space by cleaning up build artifactsNot shown working
- Release ballast pools on several volumesNot shown working
- Recover a full disk in zero-write emergency modeNot shown working
How far pickfit got
Linux x86_64
- Installs
- Starts
- 1 of 4 features work
- Works offline
macOS: the project says it runs there; pickfit hasn’t tried it.
Good for
- provision per-volume ballast pools
- protect critical projects from cleanup
- scan projects for cleanup candidates
- execute safe cleanup to target free space
- recover critically full disk in emergency mode
An alternative to Cron + rm scripts, Generic temp cleaners and Manual cleanup.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 0.7.9
Differences the test machine hit
- README: curl -fsSL .../install.sh | bash
In the test: downloaded to /tmp/install_sbh.sh, read it, then ran bash /tmp/install_sbh.sh - README: sbh emergency /data --target-free 10 --yes
In the test: sbh emergency has no --dry-run; used sbh emergency /tmp/sbh-test --target-free 1 --yes which exits 0 with nothing to reclaim