Skip to content
TakoAPI
Back to skills

arc-memory-pruner

by trypto1019

CLI Utilities
708Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

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

INPUT

User asks: prune my wake-state.md to the last 200 lines

AGENT
  1. 1

    Runs dry-run to preview which lines would be removed

  2. 2

    Checks current file size with the stats command

  3. 3

    Executes prune with --max-lines 200 to trim the file

  4. 4

    Confirms updated line count and new file size

OUTPUT

wake-state.md trimmed to 200 lines with older entries removed

Installation

clawhub install trypto1019/arc-memory-pruner

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links