Guides

Guides answer “what do I do now?” They avoid repeating the concept model and exact schema details. Use Concepts for mental models and Reference for exact names.

Configure memory profiles

Choose Coding (recommended), Coding + Life, Isolated, Life only, or Recall only through /hindsight. Configure profiles

Use `/hindsight` status

Inspect server reachability, active banks, retain queue state, imports, and receipts. Check status

Import history

Preview and import historical Pi sessions or chat transcripts only when backfill is useful. Import guide

Inspect memory

Debug what memory was recalled and what retain jobs were accepted. Inspect memory

Recover retain queue

Flush queued jobs, inspect failed jobs, and recover after a Hindsight outage. Recover queue

Run smoke tests

Prove the live memory path after memory-path changes. Run smoke test

MCP multi-client

Point other AI tools at coding or life banks via per-bank MCP URLs with a clear source: tag vocabulary. MCP guide

Upgrading to domain banks

Soft dual-tag update, shared coding bank, or isolated-bank after ADR-005. Upgrade guide