history-pruner

Prune old Claude Code history files using conservative or aggressive modes to trim JSONL files and remove large tool results and thinking blocks. Conservative mode keeps 7 days of history; aggressive keeps 3 days and removes tool_results entirely for older entries, reclaiming significant disk space without losing recent context.

Yes, run the pruning script with --dry-run mode to simulate the operation and see what would be removed without modifying files. Backups are automatically created before any pruning executes, allowing you to restore if needed.

Conservative pruning retains 7 days of history and truncates tool results to 500 characters for older entries, preserving more context. Aggressive pruning keeps only 3 days, removes tool_results entirely for older entries, and also prunes thinking blocks and old file-history snapshots for maximum disk reclamation.

Use `du -sh ~/.claude/projects/**/*.jsonl | sort -hr | head -10` to list the largest JSONL history files in your local Claude Code projects, helping you understand where disk usage concentrates before running pruning.

Yes, the pruning script operates on all files under ~/.claude/projects, making it suitable for maintaining lean histories across multiple local projects and synced Macs to prevent disk bloat from accumulated conversation data.