ClawdScan — Session Health Analyzer

🔍 Diagnose bloat, find zombies, reclaim disk space

ClawdScan is a zero-dependency Python CLI that analyzes Clawdbot/OpenClaw session JSONL files to identify bloated sessions, zombies, stale files, and provides actionable cleanup recommendations.

Features

• Session Health Analysis - Detect bloated sessions, high message counts, disk usage patterns
• Zombie Detection - Find sessions created but never used
• Stale Session Identification - Identify sessions inactive for configurable periods
• Tool Usage Analytics - Track which tools are being used and how frequently
• Model Usage Patterns - Monitor model switching and usage trends
• Disk Space Management - Breakdown of storage usage by agent and session
• Automatic Cleanup - Safe archive and deletion of problematic sessions
• Trend Tracking - Historical analysis of session health over time
• Heartbeat Integration - Automated monitoring and alerts

Installation