Memory Management
- 1.1k installs
- 67k repo stars
- Updated August 4, 2026
- ruvnet/ruflo
Memory Management is an agent skill that persists agent patterns and retrieves semantically similar past solutions using AgentDB HNSW memory through the @claude-flow/cli memory commands.
About
Memory Management is a ruflo skill from ruvnet/ruflo that wraps @claude-flow/cli memory operations for AgentDB with HNSW indexing. Bundled shell scripts export memory to timestamped JSON backups via npx @claude-flow/cli memory export, run consolidation through hooks worker dispatch with a consolidate trigger, and report stats after optimization. Developers reach for Memory Management when coding agents must recall semantically similar prior solutions, back up memory state before risky changes, or prune and consolidate growing pattern stores. The skill integrates with the broader claude-flow hook and worker system rather than ad-hoc file copies. It suits teams running multi-session agent swarms that accumulate reusable patterns worth retrieving by similarity instead of exact string match.
- AgentDB memory with HNSW vector search for semantic pattern lookup
- Documented 150x–12,500x faster pattern retrieval positioning in skill frontmatter
- CLI flows: `memory export`, consolidation via worker dispatch, `memory stats`
- Triggers on storing successes, sharing knowledge between agents, and building a knowledge base
- Explicit skip guidance for ephemeral one-off tasks with no learning value
Memory Management by the numbers
- 1,060 all-time installs (skills.sh)
- +3 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #990 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/ruvnet/ruflo --skill memory-managementAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1.1k |
|---|---|
| repo stars | ★ 67k |
| Security audit | 2 / 3 scanners passed |
| Last updated | August 4, 2026 |
| Repository | ruvnet/ruflo ↗ |
How do you persist and search agent memory with HNSW?
Persist agent patterns and retrieve semantically similar past solutions with AgentDB HNSW memory via the claude-flow CLI.
Who is it for?
Developers running claude-flow agent swarms who need HNSW semantic recall, backup exports, and consolidation of AgentDB memory.
Skip if: Projects without @claude-flow/cli installed that only need simple markdown note files instead of vector agent memory.
When should I use this skill?
The user asks to back up agent memory, consolidate claude-flow patterns, or retrieve similar past solutions from AgentDB.
What you get
Timestamped memory JSON backups, consolidated AgentDB store, memory stats report, and semantically retrieved past agent patterns.
- Timestamped memory JSON backup
- Consolidated memory store
- Memory stats output
Files
Memory Management Skill
Purpose
AgentDB memory system with HNSW vector search. Provides 150x-12,500x faster pattern retrieval, persistent storage, and semantic search capabilities for learning and knowledge management.
When to Trigger
- need to store successful patterns
- searching for similar solutions
- semantic lookup of past work
- learning from previous tasks
- sharing knowledge between agents
- building knowledge base
When to Skip
- no learning needed
- ephemeral one-off tasks
- external data sources available
- read-only exploration
Commands
Store Pattern
Store a pattern or knowledge item in memory
npx @claude-flow/cli memory store --key "[key]" --value "[value]" --namespace patternsExample:
npx @claude-flow/cli memory store --key "auth-jwt-pattern" --value "JWT validation with refresh tokens" --namespace patternsSemantic Search
Search memory using semantic similarity
npx @claude-flow/cli memory search --query "[search terms]" --limit 10Example:
npx @claude-flow/cli memory search --query "authentication best practices" --limit 5Retrieve Entry
Retrieve a specific memory entry by key
npx @claude-flow/cli memory get --key "[key]" --namespace [namespace]Example:
npx @claude-flow/cli memory get --key "auth-jwt-pattern" --namespace patternsList Entries
List all entries in a namespace
npx @claude-flow/cli memory list --namespace [namespace]Example:
npx @claude-flow/cli memory list --namespace patterns --limit 20Delete Entry
Delete a memory entry
npx @claude-flow/cli memory delete --key "[key]" --namespace [namespace]Initialize HNSW Index
Initialize HNSW vector search index
npx @claude-flow/cli memory init --enable-hnswMemory Stats
Show memory usage statistics
npx @claude-flow/cli memory statsExport Memory
Export memory to JSON
npx @claude-flow/cli memory export --output memory-backup.jsonScripts
| Script | Path | Description |
|---|---|---|
memory-backup | .agents/scripts/memory-backup.sh | Backup memory to external storage |
memory-consolidate | .agents/scripts/memory-consolidate.sh | Consolidate and optimize memory |
References
| Document | Path | Description |
|---|---|---|
HNSW Guide | docs/hnsw.md | HNSW vector search configuration |
Memory Schema | docs/memory-schema.md | Memory namespace and schema reference |
Best Practices
1. Check memory for existing patterns before starting 2. Use hierarchical topology for coordination 3. Store successful patterns after completion 4. Document any new learnings
#!/bin/bash
# Memory Management - Backup Script
# Export memory to backup file
set -e
BACKUP_DIR="${BACKUP_DIR:-./.backups}"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
BACKUP_FILE="${BACKUP_DIR}/memory_${TIMESTAMP}.json"
mkdir -p "$BACKUP_DIR"
echo "Backing up memory to $BACKUP_FILE..."
npx @claude-flow/cli memory export --output "$BACKUP_FILE"
echo "Backup complete: $BACKUP_FILE"
#!/bin/bash
# Memory Management - Consolidate Script
# Optimize and consolidate memory
set -e
echo "Running memory consolidation..."
npx @claude-flow/cli hooks worker dispatch --trigger consolidate
echo "Memory consolidation complete"
npx @claude-flow/cli memory stats
Related skills
Setup Matt Pocock SkillsScaffold the per-repo configuration that Matt Pocock’s engineering agent skills rely on so they understand the issue tracker, triage labels, and domain documentation la495k196k
Lark AppsConnect Claude, Cursor or custom agents directly to Lark (Feishu) for messaging, document automation, approval workflows and enterprise data access.402k
CavemanSlash token usage by roughly 75% while keeping every technical detail intact when working with Claude Code, Cursor or similar agents.391k94.7k
Lark Skill MakerQuickly turn any Lark/Feishu OpenAPI call or multi-step workflow into a reusable agent skill with its own SKILL.md.386k16k
Running Claude Code Via Litellm CopilotRun Claude Code at a fraction of the cost by routing requests through LiteLLM to the GitHub Copilot Chat API.270k72
Codex PetGenerate a complete Codex Pet spritesheet and metadata from one reference image without needing an OpenAI key or Codex Pro.246k10Forks & variants (1)
Memory Management has 1 known copy in the catalog totaling 96 installs. They canonicalize to this original listing.
- ruvnet - 96 installs
How it compares
Pick Memory Management for claude-flow AgentDB HNSW workflows; use YAML fact skills when structured supersession beats vector similarity.
FAQ
What CLI does Memory Management use for exports?
Memory Management runs npx @claude-flow/cli memory export --output to write timestamped JSON backups. Bundled scripts default to a ./.backups directory and name files memory_YYYYMMDD_HHMMSS.json.
How does Memory Management retrieve past agent solutions?
Memory Management leverages AgentDB HNSW memory through @claude-flow/cli so agents find semantically similar prior patterns. Consolidation is triggered via hooks worker dispatch with a consolidate trigger before stats are printed.
Is Memory Management safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.