What problem does it solve?
It solves the problem of losing valuable context across Claude Code subagent runs by providing a persistent, searchable memory system that can store experiences, retrieve the most relevant ones, and continuously improve memory quality from feedback.
Core Features & Use Cases
- Associative memory storage: saves subagent task outcomes as Markdown notes with YAML frontmatter metadata for later retrieval.
- Three-dimensional relevance retrieval: ranks memories using recency, importance, and BM25-style relevance, and supports spreading activation through memory links.
- Feedback learning and health filtering: updates memory usefulness via positive/negative feedback, categorizes memory health (healthy/warning/blocked), and filters blocked memories from future retrieval and consolidation.
- Consolidation and decay: deduplicates near-duplicate memories via Jaccard similarity merging (threshold-based) and applies Ebbinghaus-inspired exponential decay to reduce stale low-value memories.
- Prompt injection for subagents: enriches an agent prompt by injecting the top retrieved memories in a compact formatted block.
Quick Start
Use the agent-memory skill to retrieve and inject relevant historical context for the query "Implement token refresh for JWT middleware" for agent role tetsu.