Pi Hindsight documentation

Pi Hindsight gives Pi long-term memory through Hindsight. The normal workflow is:

1. install the package,
2. run /hindsight,
3. choose a memory profile,
4. let automatic Recall/Retain handle future sessions,
5. optionally import old sessions.

Start here

Install the extension, connect Hindsight, choose a profile, and verify status. Begin setup →

Use the TUI

/hindsight is the main surface for setup, status, profile changes, queue flushes, imports, and links back to these docs. Open TUI guide →

Understand the model

Concepts explain bank boundaries, Retain, Recall, Reflect, imports, queue durability, and safety. Read concepts →

Look up exact names

Reference pages list config fields, tools, commands, hooks, import controls, and generated surface details. Open reference →

Memory path

flowchart LR
  conversation[Pi conversation] --> retain[Retain raw structured content]
  retain --> bank[Project Memory Bank]
  prompt[Future prompt] --> recall[Recall relevant candidates]
  bank --> recall
  recall --> context[Ephemeral context block]
  bank --> reflect[Reflect for synthesis]

Safety defaults

• Project memory stays in a Project Bank by default.
• User memory is opt-in and configured intentionally.
• Recall injection is ephemeral; recalled memory is not written back into transcripts.
• Retain uses stable document IDs and queue durability.
• Automatic retain redacts common secrets before writing memory.

Task shortcuts

Choose memory scope

Compare Project + User, Project Only, User Only, and Recall Only profiles. Memory profiles

Import old sessions

Preview first, then import Pi sessions or chat transcripts only when backfill is useful. Import guide

Inspect memory

Check last recall, retain receipts, queue state, and status diagnostics. Inspection guide

Contribute

Verify docs, understand generated references, and follow issue/PR workflow. Development docs