zlog

Zlog Multi-Instance Storage Optimizer

Compress background tool logs across AI agents (~77%-99.9% space saved / fast zstd -15 fallback). Purge 0-byte empty logs. Keep transcript.jsonl intact. Safe for concurrent running agents. Skip tiny logs (<10KB) and text docs. Handle symlinks cleanly. Outputs single-line total summary.

Execution Intents

• Standard Cleanup: Triggered on "zlog", "compress logs", "clean up chat logs", "pack logs", or session wrap-up.
• Dry-Run Preview: Triggered on "preview zlog", "dry run", "test log cleanup".
• Deep Scan: Triggered on "find new AI agents", "scan disk for hidden AI logs".

Safety & Invariant Protection

• Process Locks: Query fuser -s "$f" (Linux/WSL), lsof "$f" (macOS), or [System.IO.File]::Open(..., 'None') (Windows 11 PowerShell). Skip file if active process lock exists.
• In-Flight Window: Skip files modified <60 seconds ago (-mmin +1).
• Protected Files: Exclude *.jsonl, SKILL.md, README*, LICENSE*, and files <= 10KB.

Commands

Standard Compression & Empty Log Purge (Linux, macOS, WSL, Git Bash)

for d in ~/.gemini ~/.config/Cursor ~/.cursor ~/.ollama ~/.claude ~/.config/claude-code ~/.windsurf ~/.codex ~/.cache/lm-studio; do
  if [ -d "$d" ]; then
    find -L "$d" \( -name "*.log" -o -name "*.out" -o -name "*.trace" -o -name "*.txt" \) -empty -type f -delete 2>/dev/null || true
    find -L "$d" \( -name "*.log" -o -name "*.out" -o -name "*.trace" -o -name "*.txt" \) -not -name "*.gz" -not -name "*.zst" -not -name "*.xz" -not -name "*.jsonl" -not -name "SKILL.md" -not -iname "README*" -not -iname "LICENSE*" -size +10k -mmin +1 -exec sh -c 'for f; do (command -v fuser >/dev/null 2>&1 && fuser -s "$f" 2>/dev/null) || (command -v lsof >/dev/null 2>&1 && lsof "$f" >/dev/null 2>&1) || (command -v zstd >/dev/null 2>&1 && zstd -15 -q --rm "$f") || (command -v xz >/dev/null 2>&1 && xz -9 "$f") || gzip -f "$f"; done' sh {} + 2>/dev/null || true
  fi
done
dirs=(); for d in ~/.gemini ~/.config/Cursor ~/.cursor ~/.ollama ~/.claude ~/.config/claude-code ~/.windsurf ~/.codex ~/.cache/lm-studio; do [ -d "$d" ] && [ ! -L "$d" ] && dirs+=("$d"); done; [ ${#dirs[@]} -gt 0 ] && du -ch "${dirs[@]}" 2>/dev/null | tail -n 1 || true