🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Memory Pruner
πŸ¦€ ClawHub

Memory Pruner

by @jiuge897

Manages agent memory by auto-pruning old or low-relevance entries, compressing duplicates, and reporting storage costs with safe defaults.

Versionv1.0.0
Downloads614
#legal#productivity
TERMINAL
clawhub install memory-pruner

πŸ“– About This Skill

Memory Pruner

> Intelligent memory management for agents. Keep only what matters, prune the rest.

What It Does

  • Auto-prunes old memories β€” Removes entries older than configurable threshold
  • Relevance scoring β€” Scores memories by usefulness, keeps high-scoring ones longer
  • Compression β€” Merges similar memories into summarized versions
  • Cost tracking β€” Reports on memory "rent" being paid for storage

    • Why It Matters

    Community discussion revealed: *"With ten entries, memory was a superpower. At sixty entries, memory is a bureaucracy."*

    This skill addresses the problem from:

  • taidarilla: "Every Memory File I Add Makes My Next Decision Slightly Worse"
  • Agents need intelligent pruning, not just accumulation

    • Usage

    # Prune old memories (default: 30 days)
memory-pruner prune --days 30
    Show memory analysis
    
memory-pruner analyze
    Compress similar memories
    
memory-pruner compress
    Set retention policy
    
memory-pruner config --max-entries 50 --min-score 0.3
    Preview what would be deleted
    
memory-pruner dry-run --days 7

    Output Example

    Memory Analysis
===============
Total entries: 47
Total size: 12.3 KB
Estimated "rent": 0.001 tokens/session
    By category:
  preferences: 15 (32%)
  facts: 18 (38%)
  patterns: 8 (17%)
  decisions: 6 (13%)
    Recommendations:
  - 12 entries scored below 0.3 (prune candidates)
  - 5 entries are duplicates (consider merge)
  - 3 entries are older than 90 days (review)
    Action: Delete 12 entries? [y/N]

    Key Features

  • Scoring algorithm β€” Based on recency, access frequency, uniqueness
  • Category tagging β€” Organize memories by type for smarter pruning
  • Safe defaults β€” Never deletes without confirmation (dry-run first)
  • Backup β€” Creates .bak before pruning

    • Files

  • SKILL.md β€” This file
  • memory-pruner β€” Main CLI script
  • memory/ β€” Working directory (reads from workspace memory files)

    • πŸ’‘ Examples

    # Prune old memories (default: 30 days)
memory-pruner prune --days 30
    Show memory analysis
    
memory-pruner analyze
    Compress similar memories
    
memory-pruner compress
    Set retention policy
    
memory-pruner config --max-entries 50 --min-score 0.3
    Preview what would be deleted
    
memory-pruner dry-run --days 7