blog: How oh-my-pi Built Persistent Codebase Memory on Hindsight

[benfrank241]

Summary

• Adoption case study on oh-my-pi (`github.com/can1357/oh-my-pi`) — a 10,600+ star TypeScript/Rust terminal coding agent that uses Hindsight as its long-term memory backend.
• README §11 is literally titled "Hindsight: memory the agent curates" — this post is a deep-dive on what they actually built on top of the API.
• Every code snippet and config example is pulled verbatim from the public repo (`packages/coding-agent/src/hindsight/{bank,config,seeds,state,mental-models,client}.ts` and `docs/tools/{retain,recall,reflect}.md`).

What's covered

• Bank scoping — three modes (`global` / `per-project` / `per-project-tagged`), with the actual `computeBankScope` function quoted; explanation of why their default (`per-project-tagged` with `tagsMatch: "any"`) is the right pick for a multi-repo coding agent
• Mental-models layer — the full `seeds.json` verbatim (3 seeds: user-preferences, project-conventions, project-decisions, each with `trigger.mode = "delta"` + `refresh_after_consolidation: true`); the tag-discipline foot-gun documented in their source
• Retain pipeline — the debounced queue (16-item batch / 5s interval), full-session auto-retain at session end, default config (`autoRetain: true`, `retainMode: "full-session"`, `retainContext: "omp"`)
• Recall pipeline — auto-injection with the exact preamble they use, `recall` and `reflect` tool paths, endpoint paths
• Why they replaced `@vectorize-io/hindsight-client` — minimal fetch client to control dependency surface, retries, timeouts; framed as a positive signal about API design
• Pattern recognition — closes by tying the shape back to other Hindsight-backed coding agents (Hermes, Claude Code, OpenClaw)

Files

• `hindsight-docs/blog/2026-06-05-oh-my-pi-hindsight-memory.md` — full post (~2,000 words)
• `hindsight-docs/static/img/blog/oh-my-pi-hindsight-memory.png` — placeholder cover (reuses Hermes card; swap before merge)

Coordination note

This is a public-repo source-of-truth post, but it's still about another project's adoption of Hindsight. Worth coordinating with @can1357 before publishing — quick courtesy heads-up + offer to link to their work. The post is friendly toward the project throughout; happy to tweak phrasing if anything reads off-key after that review.

Test plan

• Local Docusaurus build renders the post without broken links
• Cross-link to Hermes post resolves (`/blog/2026/05/25/hermes-coding-assistant-codebase-memory`)
• Cross-link to OpenClaw post resolves (`/blog/2026/05/27/openclaw-codebase-memory`)
• Cross-link to MCP post resolves (`/blog/2026/03/04/mcp-agent-memory`)
• All GitHub deep-links into `can1357/oh-my-pi` resolve
• Cover image swapped from placeholder to final Hindsight x oh-my-pi art before merge
• Quick courtesy ping to @can1357 before flipping to ready-for-review