heady-episodic-memory

Organize and retrieve multi-tier AI agent memories with phi-decay forgetting.

1|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/HeadyAI/heady-context --skill heady-episodic-memory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heady-episodic-memory
Source: https://github.com/HeadyAI/heady-context/tree/main/heady-skills/heady-episodic-memory
Command: npx skills add https://github.com/HeadyAI/heady-context --skill heady-episodic-memory

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about heady-episodic-memory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enable durable episodic memory for AI agents across sessions?

To enable durable episodic memory for AI agents, you need a multi-tier memory system that stores timestamped events with capacity limits and applies vector-based retrieval for context-aware reasoning across sessions.

What is phi-decay forgetting in AI memory management?

Phi-decay forgetting in AI memory management is a technique that gradually retires irrelevant memories while preserving critical ones, keeping the memory graph scalable and preventing capacity-limited stores from overflowing.

How does vector-based retrieval work for multi-tier agent memory?

Vector-based retrieval for multi-tier agent memory works by using a 384D embedding space to calculate similarity, allowing the system to hot cache top items in working memory and retrieve relevant context efficiently.

Can I share semantic facts across multiple AI agents with privacy boundaries?

Yes, you can share semantic facts across multiple AI agents by using a memory system that supports cross-agent knowledge sharing with configurable privacy boundaries to secure the memory graph.

What's the best way to consolidate extracted facts in a semantic knowledge graph?

The best way to consolidate extracted facts in a semantic knowledge graph is to apply nightly consolidation routines that process persistent semantic memories to maintain an organized and scalable knowledge base.

When should I not use a single capacity-limited episodic store for agent context?

You should not rely on a single capacity-limited episodic store when your agent requires long-term fact retention, as procedural rules and semantic facts need separate persistent tiers to avoid premature memory decay.