SkillsAdd

dicklesworthstone/storage_ballast_helper · Archived

sbh

>- Disk-pressure defense for AI coding workloads. Use when: disk full, low space, ballast, cleanup, scan artifacts, emergency, sbh daemon, sbh status.

First seen Aug 14, 2026

Installation

$ npx skills add dicklesworthstone/storage_ballast_helper --skill sbh
View on skills.sh ↗ GitHub repository ↗

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

sbh Similar · more installs
boshu2/agentops

Inspect disk pressure with SBH and run one explicitly authorized recovery action. Triggers: "ch…

36 installs
cass Same author
dicklesworthstone/coding_agent_session_search

Coding Agent Session Search - unified CLI/TUI to index and search local coding agent history fr…

2.9K installs
ssh Same author
dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations

>- SSH remote access - connections, tunnels, keys, file transfers. Use when connecting to serve…

693 installs
dcg Same author
dicklesworthstone/destructive_command_guard

Destructive Command Guard - High-performance Rust hook for Claude Code that blocks dangerous co…

324 installs
More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 19
License LICENSE
Default branch main
Open issues 0
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,929 B
  • docs SUMMARY.md 158 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1 installs

SKILL.md

SBH — Storage Ballast Helper

Prevents disk-full disasters via ballast files, artifact scanning, and predictive pressure monitoring. Three-pronged: ballast (instant space), scanner (stale artifacts), special locations (/tmp, /dev/shm, swap).

Quick Check

sbh status                     # Pressure level + free space
sbh status --json | jq '.pressure'  # Machine-parseable
sbh check --need 5G            # "Do I have 5 GB free?"
sbh check --predict 30         # "Will I run out in 30 min?"

Exit codes: 0 = healthy, 1 = pressure, 2 = error.

Daemon

sbh daemon                          # Foreground (debugging)
systemctl --user start sbh          # Systemd user scope
sbh install --systemd --user --auto # Install + start (Linux)
sbh install --launchd --auto        # Install + start (macOS)
sbh install --wizard                # Guided interactive setup

Signals: SIGHUP = reload config, SIGUSR1 = force scan now, SIGTERM = graceful stop.

Ballast

Pre-allocated sacrificial files — released in milliseconds, no scanning needed.

sbh ballast status             # Per-volume inventory
sbh ballast provision          # Create/rebuild pool
sbh ballast release 3          # Free 3 files NOW
sbh ballast replenish          # Rebuild after pressure passes

Defaults: 10 x 1 GiB = 10 GiB. Ensure ballast dir is on same mount as pressure source.

Scanning & Cleanup

sbh scan /data/projects --top 20       # Rank artifacts by score
sbh clean /data/projects --dry-run     # Preview what would go
sbh clean --target-free 50G --yes      # Delete until 50 GB free

Scoring: Location (.25) + Name (.25) + Age (.20) + Size (.15) + Structure (.15) = 1.0.

Protection

sbh protect /path              # .sbh-protect marker (subtree)
sbh unprotect /path            # Remove marker

Config globs: scanner.protected_paths. Hard vetoes (always enforced): .git/ dirs, open files, age < 10 min, non-writable parents.

Emergency Recovery

Zero-write mode for near-100% full disks. No config file needed.

sbh emergency /data --yes              # Aggressive cleanup NOW
sbh emergency --target-free 10G        # Stop at 10 GB recovered

Observability

sbh dashboard                  # TUI: 7 screens (1-7 to jump)
sbh stats --window 24h         # Activity over last 24 hours
sbh blame --top 10             # Top 10 pressure sources
sbh explain --id <ID>          # Why was this decision made?

Configuration

Config: ~/.config/sbh/config.toml | Env: SBH_ prefix | Fallback: /etc/sbh/config.toml

sbh config show                # Current values
sbh config validate            # Check constraints
sbh config set KEY VALUE       # Change a value
sbh tune --apply --yes         # Auto-tune for this system

Anti-Patterns

Don't Do Instead
Ballast on /tmp paths.ballast_dir on same mount as pressure source
Daemon as root, CLI as user --user scope — avoids state file permission mismatch
Skip pre-build check sbh check --need 10G in CI/hook
Delete .sbh-protect by hand sbh unprotect /path
Wait for Red to act Act at Yellow — agent swarms escalate fast
minfileage_minutes = 0 Keep >= 5 to protect in-flight writes

Reference Index

Topic File
All commands, flags, env vars [COMMANDS.md](references/COMMANDS.md)
Full config key reference [CONFIG.md](references/CONFIG.md)
Error codes, symptom-fix tables [TROUBLESHOOTING.md](references/TROUBLESHOOTING.md)
Architecture, safety layers, internals [ARCHITECTURE.md](references/ARCHITECTURE.md)