arc-memory-pruner
by trypto1019
CLI UtilitiesBrief
Automatically prune and compact agent memory files to prevent unbounded growth.
Description
What This Skill Does
Prunes and compacts agent memory files to prevent unbounded growth. Enforces line limits, rotates log directories with a circular buffer, and removes stale state entries by date. Includes a dry-run mode to preview changes before applying them.
Combines log rotation, date-based compaction, and line-based pruning in a single script rather than requiring separate tools for each operation.
When to Use It
- Trimming agent wake-state files that have grown too large
- Rotating log directories to keep only the last 7 runs
- Removing outdated state entries older than a specific date
- Checking memory file sizes before a long agent session
- Previewing what would be deleted before committing a prune
Example Workflow
User asks: prune my wake-state.md to the last 200 lines
- 1
Runs dry-run to preview which lines would be removed
- 2
Checks current file size with the stats command
- 3
Executes prune with --max-lines 200 to trim the file
- 4
Confirms updated line count and new file size
wake-state.md trimmed to 200 lines with older entries removed
Installation
clawhub install trypto1019/arc-memory-prunerRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.