# Episodic Memory

> Search past conversations for context, decisions, and patterns. Use when the user references previous work or when you encounter familiar problems.

- Skill: `dwsy/episodic-memory` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dwsy/episodic-memory`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dwsy/episodic-memory/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Dwsy (https://skillmd.com/u/dwsy)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/dwsy/episodic-memory

---


# Episodic Memory

You have access to a searchable index of all past pi conversations across all projects.

## When to Search

- User says "like we did before", "remember when", "how did we solve X", "what did we try"
- User references a past session, project, or decision
- You encounter an error or pattern that might have been addressed previously
- Starting work on a feature similar to something done before
- User asks about project history or past decisions

## How to Search

Use the `episodic_memory_search` tool:

```
// Semantic search (finds by meaning, not just keywords)
{ "query": "authentication middleware implementation" }

// Multi-concept AND search (results must match ALL concepts)
{ "query": ["React Router", "authentication", "JWT"] }

// Filter by date
{ "query": "database migration", "after": "2025-01-01" }

// Text search for exact phrases
{ "query": "useAuth hook", "mode": "text" }
```

## Tips for Good Queries

- Use descriptive phrases, not single keywords
- Try the problem description, not just the solution
- If first search doesn't find it, try rephrasing or broadening
- Use multi-concept search when looking for a specific intersection of topics

## Viewing Full Conversations

If a search result snippet isn't enough context, use `episodic_memory_show` with the session file path from the search results to see the full conversation.

## Important

- Search results are snippets (chunks of ~4 turns). They show the relevant part, not the whole conversation.
- Results include a relevance score — higher is better.
- The project name in results shows which directory the session was in.
- Don't search for every query — only when past context would genuinely help.