Inspect. Migrate. Govern.
A local-first workspace for structured AI memory, with a plugin-ready dashboard.
English · 简体中文 · Migration guide · Privacy
Memory can shape an assistant's answers, but users need more than a hidden store: they need to inspect what was retained, understand what surfaced, and change it. Pensieve brings observability, portability and user control into one local interface.
Pensieve manages external structured memory, not model weights or internal attention. The shipped adapters use Pensieve's own repository. They do not automatically read or modify private ChatGPT, Claude, Codex or Claude Code memories.
| Capability | What you can do |
|---|---|
| Memory Library | Import versioned JSON or plain text without asking a question; preview additions, duplicates and conflicts |
| Portable backups | Export selected or eligible records as JSON or text; preserve metadata in JSON |
| Editing and governance | Edit content/keywords, pin, soften, hide, restore or confirm deletion; changes affect actual retrieval |
| Safer persistence | Revision checks, exclusive write locks, atomic file replacement and pre-change backups |
| English / Chinese | Switch interface language without translating your memories or generated answers |
| Credential protection | Replace recognized credentials with [REDACTED:...] in model input, generated text, reports and errors |
| Release hygiene | Runtime data and secrets excluded from packages; developer diagnostic route removed |
| Route | Purpose |
|---|---|
/ |
Overview, current session and entry points |
/memories |
Import → preview → confirm → manage → export |
/guide |
Concepts and operating guidance |
/user-view |
Priority keywords, themes and ranked memory cards |
/surface-model |
Mock/Live queries, answers, explanations, request trace and simulated heatmap |
/dashboard |
Query-free dashboard and mock host preview |
/plugin |
Host-adapter preview; not a native host-memory connection |
Use Node.js 22.18+ (Node 22 LTS is used in CI).
git clone https://github.com/DrJonaC/Pensieve.git
cd Pensieve
npm ci
npm run devOpen http://127.0.0.1:3000/memories. A new library starts with bundled sample memories. No API key is needed for memory management or Mock mode.
For optional Live mode, create .env.local in the project root:
OPENAI_API_KEY=your_api_key_hereThe server uses the OpenAI Responses API. Only explicitly submitting a Live query
sends the filtered query and selected memory context to the model. Never commit
.env.local. Restart the app after changing server configuration.
npm run build
npm run startBoth local commands bind to loopback. This is a single-user application, not an authenticated public service. Do not expose it publicly without access controls.
JSON / text → validated preview → shared file repository
↓
dashboard / memory management / local retrieval
↓
Mock answer or filtered server-side LLM call
↓
answer + explanation + simulated heatmap
- The default store is
data/pensieve-memory-records.json;PENSIEVE_DATA_DIRcan relocate runtime data, including governance reports. - Retrieval uses a local lexical vector index rebuilt from current records, followed by ranking modifiers. It is not an external semantic embedding service.
- Hidden/deleted records are excluded from retrieval; edits replace indexed content.
- Providers separate memory access from host adapters and UI. Governance reports record desired state, with JSON manifests and verification receipts.
- The heatmap is an illustrative local surface, not measured model attention or causal attribution. Model-generated explanations are interpretations, not proof.
Credential filtering is best-effort, not a complete secret or personal-data detector. It covers recognized token formats, labeled credentials, private keys and selected server-secret values. Errors retain their original language after filtering.
Raw memories, source records, exports and backups remain original, unencrypted local data. Review before sharing. Deletion removes the active record, not every historical backup; it is not secure erasure. Existing exposed keys must be rotated.
Imports merge by default without silently overwriting conflicts. JSON roundtrips preserve source metadata, timestamps and governance state. Text is stored as supplied, one nonempty line per memory, without inferring personal facts. Neither export format is advertised as a native ChatGPT/Claude backup format.
See migration and recovery and privacy boundaries.
npm run typecheck
npm test
npm run test:package
npm run buildThe migration/privacy update passed 72 unit tests, 4 package-policy checks, strict
TypeScript and a production build. Browser suites cover memory management,
localization and credential redaction using an isolated library and synthetic data.
No real-provider call is included in those checks. See scripts/check-*-ui.mjs
and the verification instructions.
The product contribution is a user-facing memory control surface; the engineering contribution is shared persistence and provider/host boundaries. Research questions include how users interpret retrieval, how governance affects future recall, and how to verify that user decisions were applied.
Native host-memory write-back, semantic embedding providers, broader privacy classification and measured pre/post governance evaluations remain future work. See the plugin setup reference, architecture, and project showcase.
MIT. Focused contributions to providers, governance, privacy and evaluation are welcome.
