Claude-code-flow memory-management

install

source · Clone the upstream repo

git clone https://github.com/ruvnet/ruflo

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/ruvnet/ruflo "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.agents/skills/memory-management" ~/.claude/skills/ruvnet-claude-code-flow-memory-management && rm -rf "$T"

manifest: .agents/skills/memory-management/SKILL.md

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 patterns

Example:

npx @claude-flow/cli memory store --key "auth-jwt-pattern" --value "JWT validation with refresh tokens" --namespace patterns

Semantic Search

Search memory using semantic similarity

npx @claude-flow/cli memory search --query "[search terms]" --limit 10

Example:

npx @claude-flow/cli memory search --query "authentication best practices" --limit 5

Retrieve 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 patterns

List 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 20

Delete 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-hnsw

Memory Stats

Show memory usage statistics

npx @claude-flow/cli memory stats

Export Memory

Export memory to JSON

npx @claude-flow/cli memory export --output memory-backup.json

Scripts

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

Check memory for existing patterns before starting
Use hierarchical topology for coordination
Store successful patterns after completion
Document any new learnings