Skip to content
Back to search

Pensieve

Observe how memory shapes an answer. Pensieve is an interactive system for visualizing, interpreting, and managing how Large Language Models (LLMs) “remember” a user. It bridges the gap between model-level mechanisms and user-level understanding, making AI memory observable, explainable, and partially controllable.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/drjonac--pensieve/badge.svg)](/listings/drjonac--pensieve)

HTML

<a href="/listings/drjonac--pensieve"><img src="/api/listings/drjonac--pensieve/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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 dev

Open **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_here

The 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 start

Both local commands bind to loopback. This is a single-user application, **not an authenticated public service**. Do not expose it publicly without access controls.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 157 lines
  1. <div align="center">
  2. # Pensieve: Know How AI Remembers You
  3. **Inspect. Migrate. Govern.**
  4. A local-first workspace for structured AI memory, with a plugin-ready dashboard.
  5. [English](README.md) · [简体中文](README.zh-CN.md) · [Migration guide](docs/MEMORY_MIGRATION.md) · [Privacy](docs/PRIVACY.md)
  6. ![MIT](https://img.shields.io/badge/license-MIT-718b84?style=flat-square)
  7. ![Next.js](https://img.shields.io/badge/Next.js-15.5-263d38?style=flat-square)
  8. ![TypeScript](https://img.shields.io/badge/TypeScript-strict-789fa3?style=flat-square)
  9. ![Status](https://img.shields.io/badge/status-local%20research%20preview-a8bab4?style=flat-square)
  10. ![Pensieve concept illustration, not a product screenshot](docs/assets/pensieve-hero.png)
  11. </div>
  12. ## Why Pensieve?
  13. Memory can shape an assistant's answers, but users need more than a hidden store:
  14. they need to inspect what was retained, understand what surfaced, and change it.
  15. Pensieve brings **observability, portability and user control** into one local interface.
  16. Pensieve manages **external structured memory**, not model weights or internal attention.
  17. The shipped adapters use Pensieve's own repository. They do not automatically read or
  18. modify private ChatGPT, Claude, Codex or Claude Code memories.
  19. ## What's New
  20. | Capability | What you can do |
  21. | --- | --- |
  22. | Memory Library | Import versioned JSON or plain text without asking a question; preview additions, duplicates and conflicts |
  23. | Portable backups | Export selected or eligible records as JSON or text; preserve metadata in JSON |
  24. | Editing and governance | Edit content/keywords, pin, soften, hide, restore or confirm deletion; changes affect actual retrieval |
  25. | Safer persistence | Revision checks, exclusive write locks, atomic file replacement and pre-change backups |
  26. | English / Chinese | Switch interface language without translating your memories or generated answers |
  27. | Credential protection | Replace recognized credentials with `[REDACTED:...]` in model input, generated text, reports and errors |
  28. | Release hygiene | Runtime data and secrets excluded from packages; developer diagnostic route removed |
  29. ## Explore the App
  30. | Route | Purpose |
  31. | --- | --- |
  32. | `/` | Overview, current session and entry points |
  33. | `/memories` | Import → preview → confirm → manage → export |
  34. | `/guide` | Concepts and operating guidance |
  35. | `/user-view` | Priority keywords, themes and ranked memory cards |
  36. | `/surface-model` | Mock/Live queries, answers, explanations, request trace and simulated heatmap |
  37. | `/dashboard` | Query-free dashboard and mock host preview |
  38. | `/plugin` | Host-adapter preview; not a native host-memory connection |
  39. ![Pensieve overview with bundled sample data](docs/assets/home-overview.png)
  40. ## Quick Start
  41. Use Node.js 22.18+ (Node 22 LTS is used in CI).
  42. ```bash
  43. git clone https://github.com/DrJonaC/Pensieve.git
  44. cd Pensieve
  45. npm ci
  46. npm run dev
  47. ```
  48. Open **http://127.0.0.1:3000/memories**. A new library starts with bundled sample
  49. memories. No API key is needed for memory management or Mock mode.
  50. For optional Live mode, create `.env.local` in the project root:
  51. ```dotenv
  52. OPENAI_API_KEY=your_api_key_here
  53. ```
  54. The server uses the OpenAI Responses API. Only explicitly submitting a Live query
  55. sends the filtered query and selected memory context to the model. Never commit
  56. `.env.local`. Restart the app after changing server configuration.
  57. ```bash
  58. npm run build
  59. npm run start
  60. ```
  61. Both local commands bind to loopback. This is a single-user application, **not an
  62. authenticated public service**. Do not expose it publicly without access controls.
  63. ## How It Works
  64. ```text
  65. JSON / text → validated preview → shared file repository
  66. ↓
  67. dashboard / memory management / local retrieval
  68. ↓
  69. Mock answer or filtered server-side LLM call
  70. ↓
  71. answer + explanation + simulated heatmap
  72. ```
  73. - The default store is `data/pensieve-memory-records.json`; `PENSIEVE_DATA_DIR`
  74. can relocate runtime data, including governance reports.
  75. - Retrieval uses a local lexical vector index rebuilt from current records,
  76. followed by ranking modifiers. It is not an external semantic embedding service.
  77. - Hidden/deleted records are excluded from retrieval; edits replace indexed content.
  78. - Providers separate memory access from host adapters and UI. Governance reports
  79. record desired state, with JSON manifests and verification receipts.
  80. - The heatmap is an illustrative local surface, **not measured model attention or
  81. causal attribution**. Model-generated explanations are interpretations, not proof.
  82. ## Privacy and Recovery
  83. Credential filtering is best-effort, not a complete secret or personal-data detector.
  84. It covers recognized token formats, labeled credentials, private keys and selected
  85. server-secret values. Errors retain their original language after filtering.
  86. **Raw memories, source records, exports and backups remain original, unencrypted
  87. local data.** Review before sharing. Deletion removes the active record, not every
  88. historical backup; it is not secure erasure. Existing exposed keys must be rotated.
  89. Imports merge by default without silently overwriting conflicts. JSON roundtrips
  90. preserve source metadata, timestamps and governance state. Text is stored as supplied,
  91. one nonempty line per memory, without inferring personal facts. Neither export format
  92. is advertised as a native ChatGPT/Claude backup format.
  93. See [migration and recovery](docs/MEMORY_MIGRATION.md) and [privacy boundaries](docs/PRIVACY.md).
  94. ## Verification
  95. ```bash
  96. npm run typecheck
  97. npm test
  98. npm run test:package
  99. npm run build
  100. ```
  101. The migration/privacy update passed 72 unit tests, 4 package-policy checks, strict
  102. TypeScript and a production build. Browser suites cover memory management,
  103. localization and credential redaction using an isolated library and synthetic data.
  104. No real-provider call is included in those checks. See `scripts/check-*-ui.mjs`
  105. and the [verification instructions](docs/MEMORY_MIGRATION.md#verification).
  106. ## Integration and Research
  107. The product contribution is a user-facing memory control surface; the engineering
  108. contribution is shared persistence and provider/host boundaries. Research questions
  109. include how users interpret retrieval, how governance affects future recall, and
  110. how to verify that user decisions were applied.
  111. Native host-memory write-back, semantic embedding providers, broader privacy
  112. classification and measured pre/post governance evaluations remain future work.
  113. See the [plugin setup reference](CODEX_PLUGIN_INSTALL.md),
  114. [architecture](PENSIEVE_DASHBOARD_PLUGIN_DESIGN.md), and
  115. [project showcase](docs/PENSIEVE_REPO_SHOWCASE.md).
  116. ## License
  117. [MIT](LICENSE). Focused contributions to providers, governance, privacy and evaluation are welcome.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.