| name | memory-management |
| description | 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. Use when: 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. Skip when: no learning needed, ephemeral one-off tasks, external data sources available, read-only exploration.
|
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
