Is it safe to run this skill on my active projects?

Yes. The skill includes a 'conservative' default mode that keeps the last 7 days of full history and provides a dry-run option to verify changes first.

Does pruning delete my conversation context?

No, the skill specifically preserves messages and summaries. It only truncates large tool outputs and removes old internal metadata to save space.

Can I automate the history cleanup?

Yes, the skill is designed to be compatible with crontab or launchd, allowing you to schedule weekly automated cleanups.

Will truncating tool results break Claude Code?

No, Claude Code is built to handle truncated or missing tool data gracefully, so your current conversation context remains functional.

What project file size triggers a need for pruning?

It is recommended to use the history-pruner when project files in your claudesync directory exceed 50MB to ensure smooth performance.

History Pruner

Name: History Pruner
Author: Folly-Partners

byFolly-Partners

生产力与工作流

Optimizes local storage by pruning bloated Claude Code conversation history and truncating large tool outputs.

关于

The History Pruner skill is an essential maintenance utility for developers using Claude Code who experience disk space issues or performance lag caused by accumulating conversation logs. It intelligently scans project JSONL files to truncate massive tool outputs and remove outdated snapshots while preserving essential message structures and summaries. By keeping project files below the 50MB threshold, it ensures faster synchronization across devices via tools like ClaudeSync and prevents GitHub sync failures due to oversized files, all while maintaining Claude's ability to handle context gracefully.

主要功能

Seamless integration with crontab for automated weekly maintenance
Conservative and aggressive pruning modes for flexible data retention
Automated removal of old thinking blocks and file history snapshots
0 GitHub stars
Intelligent truncation of tool results to preserve metadata while saving space
Dry-run capability to preview potential storage savings before execution

使用场景

Performing routine maintenance to keep Claude Code environments lean and performant
Optimizing Git-based sync operations by reducing bulky JSON content
Recovering disk space when project log files exceed recommended size limits

关于

主要功能

Seamless integration with crontab for automated weekly maintenance
Conservative and aggressive pruning modes for flexible data retention
Automated removal of old thinking blocks and file history snapshots
0 GitHub stars
Intelligent truncation of tool results to preserve metadata while saving space
Dry-run capability to preview potential storage savings before execution

使用场景

Performing routine maintenance to keep Claude Code environments lean and performant
Optimizing Git-based sync operations by reducing bulky JSON content
Recovering disk space when project log files exceed recommended size limits