CLI-Anything Bundle #4 — Disk Recon Pack

Four agent-native CLI skills that answer the disk questions before you act: diskhog (what is hogging space), dupescan (what is duplicated), permscan (which permissions are risky), freshfind (what changed lately). Python 3.8+, zero dependencies, Apache 2.0.

Safety contract: all four skills are strictly read-only over everything they inspect. No deletes, no permission changes, no writes inside the scanned tree, no network. Symlinks are never followed or counted.

1. Unzip

unzip CLI-Anything_Bundle4_DiskRecon_v1.0.zip

2. Use with your AI agent

Copy any skill folder (the one containing its SKILL.md) into your agent's skills directory — for OpenClaw that is ~/.openclaw/skills/:

cp -r diskhog ~/.openclaw/skills/
cp -r dupescan ~/.openclaw/skills/
cp -r permscan ~/.openclaw/skills/
cp -r freshfind ~/.openclaw/skills/

The agent then knows the commands, the JSON flags, and the safety contract.

3. Or run as plain CLIs (no agent needed)

python3 diskhog/agent-harness/cli_anything/diskhog/__main__.py summary .
python3 dupescan/agent-harness/cli_anything/dupescan/__main__.py scan . --min-size 4096
python3 permscan/agent-harness/cli_anything/permscan/__main__.py scan .
python3 freshfind/agent-harness/cli_anything/freshfind/__main__.py find . --since-days 7

4. Optional pip install (per skill)

cd diskhog/agent-harness && pip install .
# then: cli-anything-diskhog summary .

5. Verify before you trust it

Every skill ships its own self-test battery — 64 checks total:

python3 diskhog/agent-harness/cli_anything/diskhog/tests/test_core.py      # 19 checks
python3 dupescan/agent-harness/cli_anything/dupescan/tests/test_core.py    # 15 checks
python3 permscan/agent-harness/cli_anything/permscan/tests/test_core.py    # 16 checks
python3 freshfind/agent-harness/cli_anything/freshfind/tests/test_core.py  # 14 checks

Each battery prints PASS/FAIL per check and exits non-zero on any failure. Filesystems that quietly drop SUID/SGID bits get honest SKIPs from permscan, never fake passes.

Command surface

skillcommands
diskhogfiles ROOT --top M · dirs ROOT --depth N --top M · summary ROOT (all with --json)
dupescanscan ROOT --min-size B · report ROOT OUT --min-size B
permscanscan ROOT · explain 4755
freshfindfind ROOT --since-days D --top M · summary ROOT --buckets 1,7,30
Honest limits: these are recon tools. They report; they do not fix. Dupescan will never delete a duplicate for you — it gives you the evidence and you decide. Permscan will never chmod anything. Free-tier direct downloads of this pack are also published on the tikkunolam.today downloads rail.

Apache 2.0 — run it, modify it, ship it inside your own products. Bundle lineage: #1 Builder/Skills · #2 Agent Ops · #3 System Truth · #4 Disk Recon.