Configure memory profiles

Use the narrowest memory route that fits the repository. Start with Project Only for strict isolation or Project + User for personal coding with durable cross-repo preferences.

Choose a profile

Profile	Recall reads	Automatic retain writes	Best for
Project + User	Project Bank plus User Bank	Project Bank	personal coding with durable preferences
Project Only	Project Bank	Project Bank	client work, sensitive repos, shared repos
User Only	User Bank	user-memory policy	intentional user-only memory
Recall Only	configured memory banks	disabled	cautious adoption and read-only sessions

Configure through /hindsight

1. Run /hindsight.
2. Open guided setup if prompted, or rerun it from the TUI.
3. Set the Hindsight base URL.
4. Choose the memory profile.
5. Confirm the project and/or user bank IDs.
6. Review whether setup will write project config, global Pi config, or both.

Configure by file

A minimal project config points at a Hindsight server:

{
  "hindsight": {
    "baseUrl": "http://localhost:8888"
  }
}

Pin a human-chosen Project Bank when stability matters:

{
  "hindsight": {
    "baseUrl": "http://localhost:8888"
  },
  "banks": {
    "project": {
      "derive": "manual",
      "bankId": "pi-project-my-repo"
    }
  }
}

Verify

Run /hindsight and confirm:

• expected profile is active
• expected Project Bank is selected only when project memory is intended
• User Bank appears only when explicitly configured
• automatic retain is enabled only where expected
• retain queue path is visible

See Memory profiles for profile semantics and Configuration reference for exact fields.