heady-episodic-memory

What problem does it solve?

The skill provides a layered memory system for AI agents that combines episodic events, semantic facts, and procedural rules, enabling durable, context-rich reasoning across sessions.

Core Features & Use Cases

• Episodic memory: stores timestamped events with capacity limits (e.g., 987 events) for retracing actions.
• Semantic memory: stores extracted facts with a persistent knowledge graph interface and nightly consolidation.
• Procedural memory: keeps learned action rules and recipes for repeatable behaviors.
• Phi-decay forgetting: applies phi-based decay to gradually retire irrelevant memories while preserving critical ones.
• Working memory and retrieval: hot caches the top 21 items and uses vector similarity with a 384D embedding space.
• Cross-agent sharing and privacy: supports cross-agent knowledge sharing with privacy boundaries.

Quick Start

Initialize heady-episodic-memory for an agent and store an initial episodic memory entry.