***

title: Episodes
description: >-
Structured conversation summaries that capture what happened, what was
decided, and what's open.
-------------------------

# Episodes

An episode is a structured summary of a conversation session. It captures the arc of the interaction — not a verbatim transcript, but a distillation of outcomes.

## What an episode contains

* **Summary** — what was discussed and what happened
* **Decisions made** — beliefs established or revised during the session
* **Open threads** — unresolved questions or next steps
* **Linked beliefs** — facts that were created or modified in this session

## When episodes are created

Episodes are extracted automatically when the system flushes a conversation segment. The extraction pipeline generates the episode summary in parallel with fact and artifact extraction.

For Chrome extension users, episodes are created as you chat in ChatGPT, Claude, or Gemini — no manual action needed.

## How episodes help retrieval

When you search for context, episodes provide temporal grounding. If you ask "what did we discuss about the API design?", the system can return the episode where that discussion happened, along with the specific beliefs it established.

Episodes also support **co-occurrence expansion** during retrieval — if a fact was established in an episode, other facts from the same episode may be relevant too.

## API

| Operation | Endpoint                   |
| --------- | -------------------------- |
| List      | `GET /v1/episodes`         |
| Search    | `GET /v1/episodes/search`  |
| Get       | `GET /v1/episodes/{id}`    |
| Delete    | `DELETE /v1/episodes/{id}` |