CLI-Anything Bundle #5 — Log Ops Pack

Four agent-native CLI skills that answer the log questions before you act: logskim (what does this log hold at a glance), errrate (when do errors hit and which ones repeat), logdiff (what changed between two snapshots), logfilter (which lines match what you asked for). Python 3.8+, zero dependencies, Apache 2.0.

Safety contract: all four skills are strictly read-only over everything they inspect. No writes, no deletes, no moves, no permission changes, no network. Binary noise never crashes a read (errors='replace'). Syslog stamps carry no year — the year is caller-supplied, never silently guessed.

1. Unzip

unzip CLI-Anything_Bundle5_LogOps_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 logskim ~/.openclaw/skills/
cp -r errrate ~/.openclaw/skills/
cp -r logdiff ~/.openclaw/skills/
cp -r logfilter ~/.openclaw/skills/

3. Or run as a plain CLI

python3 logskim/agent-harness/cli_anything/logskim/__main__.py levels app.log
python3 errrate/agent-harness/cli_anything/errrate/__main__.py timeline app.log --bucket m
python3 logdiff/agent-harness/cli_anything/logdiff/__main__.py diff old.log new.log --normalize
python3 logfilter/agent-harness/cli_anything/logfilter/__main__.py counts app.log --min-level ERROR

Every command accepts --json (before or after the subcommand) and reads - as stdin where a PATH is taken. A line appearing 3x in the new snapshot and 1x in the old is honestly reported as "added 2" — multiset truth.

4. Verify before you trust (78 checks)

python3 logskim/agent-harness/cli_anything/logskim/tests/test_core.py      # 22 checks
python3 errrate/agent-harness/cli_anything/errrate/tests/test_core.py      # 20 checks
python3 logdiff/agent-harness/cli_anything/logdiff/tests/test_core.py      # 16 checks
python3 logfilter/agent-harness/cli_anything/logfilter/tests/test_core.py  # 20 checks

Each battery prints PASS/FAIL per check and exits non-zero on any failure. The batteries also live-fire each skill's real CLI end-to-end (verified 2026-10-18: 78 checks, 0 failed).

5. Command surface

skillcommands
logskimskim PATH [--lines N] · levels PATH · top PATH [--top M] [--template] · range PATH [--syslog-year YYYY]
errratetimeline PATH [--bucket s|m|h] [--size N] [--include-warn] · toperrors PATH [--top M]
logdiffdiff A B [--normalize] · new A B [--top M] [--exact]
logfilterfilter PATH [--level LVL] [--min-level LVL] [--include RE]... [--exclude RE]... [--since TS] [--until TS] · counts PATH [same filters]

6. The family (all on the free rail)

License: Apache 2.0 — yours to run, modify, and ship anywhere, including inside your own products. Support: [email protected].

Built on SoulTech AI by Kiwann Williams. All Is One. One Is All.