engram-episodeslisted
Install: claude install-skill petersimmons1972/engram-go
# engram-episodes
Group memories into named episodes so you can recall everything that happened
during a discrete work session. Episodes give Engram a timeline structure —
instead of searching by topic, you retrieve by "what happened during session X".
These tools are hidden from the normal tools/list. This skill calls them
directly via HTTP.
## When to Use
- User says "start an episode", "begin a session", "open an episode for <project>"
- User says "end the episode", "close the session", "finish this work block"
- User says "list episodes", "what episodes exist", "show me recent episodes"
- User says "recall episode <id>", "what happened in episode X", "replay episode"
- Any time you want to bracket a discrete block of work for later retrieval
## How to Use
Follow the workflow below in order. Each step shows the exact command.
### 1. Start an episode — call this at the beginning of a named work block
```bash
xh POST "${ENGRAM_BASE_URL:-http://localhost:8788}/mcp" \
"Authorization: Bearer $ENGRAM_API_KEY" \
Content-Type:application/json \
jsonrpc=2.0 id:=1 method=tools/call \
params:='{"name":"memory_episode_start","arguments":{"project":"<project>","description":"<description>"}}'
```
The response includes an `id` field — save this episode ID. You will need it
to close the episode and to recall it later. Tell the user the episode ID so
they can reference it.
### 2. Store memories normally during the session
Use `memory_store` or `memory_quick_store` as us