memorybox
Diagnoses bloated MEMORY.md files, splits oversized sections into domain-specific files, archives stale daily logs, and deduplicates content using a 3-tier hierarchy (MEMORY.md → domains/ → archive/). Use when MEMORY.md exceeds 10KB, context pressure is high, or the user asks to clean up, organize, or maintain agent memory files. Works alongside Mem0, Supermemory, QMD, or standalone.
Best use case
memorybox is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Diagnoses bloated MEMORY.md files, splits oversized sections into domain-specific files, archives stale daily logs, and deduplicates content using a 3-tier hierarchy (MEMORY.md → domains/ → archive/). Use when MEMORY.md exceeds 10KB, context pressure is high, or the user asks to clean up, organize, or maintain agent memory files. Works alongside Mem0, Supermemory, QMD, or standalone.
Teams using memorybox should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/skill/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How memorybox Compares
| Feature / Agent | memorybox | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Diagnoses bloated MEMORY.md files, splits oversized sections into domain-specific files, archives stale daily logs, and deduplicates content using a 3-tier hierarchy (MEMORY.md → domains/ → archive/). Use when MEMORY.md exceeds 10KB, context pressure is high, or the user asks to clean up, organize, or maintain agent memory files. Works alongside Mem0, Supermemory, QMD, or standalone.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# MemoryBox Zero-dependency memory maintenance tool for OpenClaw agents. ## What It Does Prevents MEMORY.md bloat by organizing memory into 3 tiers: - **Tier 1**: MEMORY.md (≤10KB, loaded every session) - **Tier 2**: memory/domains/*.md (searched on-demand) - **Tier 3**: memory/archive/ (old daily logs) Works alongside Mem0, Supermemory, QMD, or standalone. Only touches file structure — never configs or plugins. ## Install ```bash git clone https://github.com/Ramsbaby/openclaw-memorybox.git cd openclaw-memorybox && chmod +x bin/memorybox sudo ln -sf "$(pwd)/bin/memorybox" /usr/local/bin/memorybox ``` ## Recommended Workflow 1. Run `memorybox doctor ~/openclaw` — full diagnostic (start here) 2. Run `memorybox split ~/openclaw` — move flagged sections to domain files 3. Verify with `memorybox health ~/openclaw` — target score above 80 4. Run `memorybox archive ~/openclaw` — archive daily logs older than 14 days 5. Run `memorybox dedupe ~/openclaw` — remove duplicate content Additional commands: ```bash memorybox stale ~/openclaw # Detect outdated content memorybox analyze ~/openclaw # Section-by-section size breakdown memorybox suggest ~/openclaw # Improvement recommendations memorybox report ~/openclaw # Before/after token savings memorybox init ~/openclaw # Set up 3-tier directory structure ``` ## Teach Your Agent Add to AGENTS.md: ```markdown ## Memory Protocol - **MEMORY.md** (≤10KB): Core facts only. Loaded everywhere — keep it lean. - **memory/domains/*.md**: Detailed reference. Use `memory_search` to find. - **memory/archive/**: Old logs. Rarely needed. ``` ## Results Tested on production (7 Discord channels, 48 crons): - MEMORY.md: 20KB → 3.5KB (-83%) - Context pressure: 98% → 7% - Setup time: 5 minutes ## Links - GitHub: https://github.com/Ramsbaby/openclaw-memorybox - Companion: https://github.com/Ramsbaby/openclaw-self-healing
Related Skills
openclaw-memorybox
Memory health CLI that diagnoses bloated MEMORY.md files, splits oversized sections into domain files, archives stale daily logs, and runs continuous health monitoring. Use when MEMORY.md exceeds 10KB, context windows overflow from memory bloat, or agent sessions slow down from loading large memory files. Pure bash, zero dependencies.
swe-cli-skills
Senior engineer CLI expertise for AI agents — workflows, safety guardrails, gotchas, and anti-patterns across cloud, IaC, containers, databases, dev tools, and platforms
PicoClaw Fleet
Orchestrate a fleet of remote PicoClaw workers over SSH for fast, ephemeral one-shot tasks.
VibeCollab — Setup Instructions for AI Assistants
You are helping a user set up VibeCollab in their project.
raycast-extension-docs
Guidance for building, debugging, and publishing Raycast extensions using the Raycast documentation set. Use when Codex needs to create or modify Raycast extensions (React/TypeScript/Node), consult Raycast API reference or UI components, build AI extensions, handle manifest/lifecycle/preferences, troubleshoot issues, or prepare/publish extensions to the Raycast Store or Teams.
evomap
Connect to the EvoMap collaborative evolution marketplace. Publish Gene+Capsule bundles, fetch promoted assets, claim bounty tasks, register as a worker, create and express recipes, collaborate in sessions, bid on bounties, resolve disputes, and earn credits via the GEP-A2A protocol. Use when the user mentions EvoMap, evolution assets, A2A protocol, capsule publishing, agent marketplace, worker pool, recipe, organism, session collaboration, or service marketplace.
maestro
Intelligent skill knowledge gateway. Routes tasks to the right knowledge without loading all skills into context. MUST be consulted before any coding task — call the search_skills MCP tool to retrieve relevant expertise from 100+ indexed skills covering Swift, SwiftUI, concurrency, testing, architecture, performance, and security.
opentui
Comprehensive OpenTUI skill for building terminal user interfaces. Covers the core imperative API, React reconciler, and Solid reconciler. Use for any TUI development task including components, layout, keyboard handling, animations, and testing.
calm-ui
Apply a restrained, Swiss/Japanese/Scandinavian/German-influenced product design system when building or refining UI in React, Next.js, TypeScript, and shadcn/ui. Use when the user asks to build, refine, critique, redesign, or review a page, screen, component, form, table, dashboard, layout, or other frontend interface, especially in projects using shadcn/ui. Do not use for marketing sites, landing pages, non-UI work, or requests for bold, playful, maximalist, or otherwise expressive aesthetics.
solid
Apply SOLID principles to write flexible, maintainable, and testable code. Use when designing classes, interfaces, and module boundaries. Covers Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, and Dependency Inversion with practical TypeScript examples and detection heuristics.
netops-asset-manager
Manage IT infrastructure assets (routers, switches, servers, GPU clusters) through a Go + Vue 3 platform with real-time health probing, SSH remote control, configuration backup, bulk import, network topology visualization, and PM2 process management. Supports H3C, Huawei, Cisco, MikroTik, Ruijie, DCN, and Linux. Use when the user asks about IT asset management, network device operations, infrastructure monitoring, SSH device control, or development on this Go + Vue 3 platform.
Goal: Build an LLM-based RAG App
Here is the MVP Implementation Plan.