← Back to Skills Marketplace
1417
Downloads
0
Stars
6
Active Installs
2
Versions
Install in OpenClaw
/install arc-memory-pruner
Description
Automatically prune and compact agent memory files to prevent unbounded growth. Circular buffer for logs, importance-based retention for state, and configura...
README (SKILL.md)
Memory Pruner
Keep your agent's memory lean. Automatically prune logs, compact state files, and enforce size limits so your agent never runs out of disk or context window.
Why This Exists
Agents accumulate memory files over time. Logs grow unbounded. State files collect stale entries. Eventually your boot-up reads 50K tokens of memory and half of it is outdated. Memory Pruner enforces limits and keeps only what matters.
Commands
Prune a memory file (keep last N lines)
python3 {baseDir}/scripts/memory_pruner.py prune --file ~/wake-state.md --max-lines 200
Prune a log directory (circular buffer, keep last N files)
python3 {baseDir}/scripts/memory_pruner.py prune-logs --dir ~/agents/logs/ --keep 7
Compact a state file (remove sections matching a pattern)
python3 {baseDir}/scripts/memory_pruner.py compact --file ~/wake-state.md --remove-before "2026-02-14"
Check memory sizes
python3 {baseDir}/scripts/memory_pruner.py stats --dir ~/
Dry run (show what would be pruned)
python3 {baseDir}/scripts/memory_pruner.py prune --file ~/wake-state.md --max-lines 200 --dry-run
Features
- Line-based pruning: Keep last N lines of any file
- Log rotation: Circular buffer for log directories (keep last N files, delete oldest)
- Date-based compaction: Remove entries older than a cutoff date
- Size limits: Enforce max file sizes in bytes
- Dry run mode: Preview changes before applying
- Stats: Overview of memory file sizes and growth rates
Usage Guidance
This skill appears coherent and low-risk for its stated purpose, but follow these precautions before using it: (1) Review the _ALLOWED_BASES list in scripts/memory_pruner.py to ensure it covers only the agent memory paths you expect; the script will block any path outside that list. (2) Run commands with --dry-run first to preview deletions. (3) Note the script refuses to prune symlinks — if your memory files are symlinked, the tool will not touch them. (4) Back up important state before running destructive operations. (5) If you need other directories pruned, modify the allowlist deliberately (and review the code change) rather than providing arbitrary paths. Overall the skill does not request secrets or network access and matches its description.
Capability Analysis
Type: OpenClaw Skill
Name: arc-memory-pruner
Version: 1.1.0
The 'arc-memory-pruner' skill is designed for legitimate agent memory management, including pruning, compaction, and statistics. The Python script `scripts/memory_pruner.py` implements a robust security control (`_validate_prune_path`) that strictly whitelists allowed directories (`~/.openclaw`, `~/.claude`, etc.) and uses `os.path.realpath` to prevent path traversal attacks. It also explicitly blocks pruning of symlinks. There is no evidence of data exfiltration, malicious command execution, persistence mechanisms, or prompt injection attempts in SKILL.md. All operations are confined to the stated purpose and secured against common file system vulnerabilities.
Capability Assessment
Purpose & Capability
Name/description (prune and compact agent memory) match the included Python script and SKILL.md. Declared requirement (python3) is appropriate and no unrelated credentials or binaries are requested.
Instruction Scope
SKILL.md examples show running the script against files/dirs like ~/wake-state.md and ~/agents/logs; the bundled script enforces an allowlist of base directories and will block operations outside those locations. That restriction is coherent with the stated purpose but means example commands that target arbitrary paths or ~ may be blocked. The script refuses symlinks and will perform destructive deletes unless --dry-run is used.
Install Mechanism
No install spec; instruction-only skill plus a local Python script. Nothing is downloaded or executed from external URLs, so install risk is low.
Credentials
No environment variables, credentials, or config paths are requested. The script operates solely on local files under a limited set of directories.
Persistence & Privilege
always is false and the skill does not request persistent/privileged platform settings. Autonomous invocation is allowed by default but not combined with other red flags here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install arc-memory-pruner - After installation, invoke the skill by name or use
/arc-memory-pruner - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
- Version bump to 1.1.0.
- scripts/memory_pruner.py updated.
v1.0.0
Initial release of memory-pruner
- Automatically prunes and compacts agent memory files to prevent unbounded growth.
- Supports circular buffer for logs and importance-based retention for state files.
- Enforces configurable size limits on logs and state files.
- Provides dry run mode to preview pruning actions without applying changes.
- Includes command-line tools to prune files/directories, compact by date, and check memory sizes.
Metadata
Frequently Asked Questions
What is Memory Pruner?
Automatically prune and compact agent memory files to prevent unbounded growth. Circular buffer for logs, importance-based retention for state, and configura... It is an AI Agent Skill for Claude Code / OpenClaw, with 1417 downloads so far.
How do I install Memory Pruner?
Run "/install arc-memory-pruner" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Memory Pruner free?
Yes, Memory Pruner is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Memory Pruner support?
Memory Pruner is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).
Who created Memory Pruner?
It is built and maintained by ArcSelf (@trypto1019); the current version is v1.1.0.
More Skills