Hindsight Self Hosted

Recall memories

hindsight memory recall $BANK "what are you looking for?"

Reflect (synthesize with reasoning)

hindsight memory reflect $BANK "question to reason about"

When to Retain

• Bug fixes and workarounds discovered
• Project conventions and patterns found
• User preferences learned (attribute by name: "Alice prefers X")
• Architecture decisions and their rationale
• Things that did NOT work (negative knowledge is valuable)
• Significant task completions (summarize what was done)

When to Recall

• Before starting any non-trivial task
• When working in unfamiliar code
• When making architecture or tooling decisions
• When a team member asks about past work

Best Practices

1. Be specific: "npm test requires --experimental-vm-modules" not "tests need a flag"
2. Include outcomes: Store what worked AND what didn't
3. Use context categories: Tag for better retrieval
4. Attribute preferences: "Alice prefers X" not just "User prefers X"
5. Don't duplicate: Recall first to check if knowledge already exists