Skip to content
Back to search

shared-ai-memory

One long-term memory shared by Claude and ChatGPT: a self-hosted MCP server on Cloudflare Workers with a one-click Windows installer (English/Español).

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/frozenfrostfox--shared-ai-memory/badge.svg)](/listings/frozenfrostfox--shared-ai-memory)

HTML

<a href="/listings/frozenfrostfox--shared-ai-memory"><img src="/api/listings/frozenfrostfox--shared-ai-memory/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.

You need: Windows 10/11, a Claude account and a ChatGPT account (ChatGPT needs **Plus** for custom connectors). A free Cloudflare account gets created along the way.

1. **Download** this repo: green **Code** button → **Download ZIP**, and unzip it anywhere (e.g. Documents). 2. **Double-click `INSTALL.bat`** and follow it. It asks your language first (English / Español). - If Windows says "Windows protected your PC": **More info → Run anyway**. - It installs Node.js and Git if they're missing, then opens your browser to sign in to Cloudflare. - You'll choose a password for your memory. Write it down. 3. At the end, **`GUIDE.html`** opens with the exact clicks to connect Claude and ChatGPT (~5 minutes).

**Even easier — let Claude do it:** open the Claude desktop app, connect this folder, and write *"Read CLAUDE-SETUP.md and set everything up for me."* Claude runs the steps and tells you where to click; your password never passes through the chat.

The installer can be re-run at any time: it resumes and never deletes anything.

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 · 109 lines
  1. # Shared AI Memory
  2. [Leer en español](README.es.md)
  3. **One long-term memory that Claude and ChatGPT both read and write** — so you can switch
  4. assistants mid-task (say, when you hit a usage limit) without re-explaining who you are or where
  5. your project stands.
  6. It's your own small server, running free on your own Cloudflare account. Both assistants connect
  7. to it as a custom connector (MCP), sign in with a password only you know, and keep it up to date
  8. as you talk to them.
  9. ![license](https://img.shields.io/badge/license-GPL--3.0-c96442)
  10. ![platform](https://img.shields.io/badge/installer-Windows%2010%2F11-c96442)
  11. ![runs on](https://img.shields.io/badge/runs%20on-Cloudflare%20Workers%20(free)-c96442)
  12. ## What you get
  13. - **One memory, two assistants.** Tell Claude something; ask ChatGPT about it later. Each project
  14. has a document with a **Next step** line, so either assistant can pick up exactly where the
  15. other left off.
  16. - **It remembers you, not just your code:** profile, preferences, and topics (studies, hardware,
  17. languages, fitness…) — filed with clear rules about what counts as something *you* said versus
  18. something the AI assumed.
  19. - **Your coding activity logs itself (optional).** A git hook, a deploy hook and an hourly scan of
  20. your code folder report what changed. If a project's notes fall behind its code, every tool
  21. result flags it as **UNRECORDED WORK** until an assistant updates them.
  22. - **Safe for two writers at once:** every write is version-checked (compare-and-swap), with full
  23. revision history and restore.
  24. - **Refuses secrets:** writes containing API keys, tokens, passwords, private keys or card numbers
  25. are rejected outright.
  26. - **Optional GitHub backup:** the whole memory can be mirrored to a private GitHub repo of yours.
  27. - **Private by design:** your server, your Cloudflare account, your password. Nothing is shared
  28. with the author of this project.
  29. ## Install (Windows, ~10 minutes, no coding needed)
  30. You need: Windows 10/11, a Claude account and a ChatGPT account (ChatGPT needs **Plus** for
  31. custom connectors). A free Cloudflare account gets created along the way.
  32. 1. **Download** this repo: green **Code** button → **Download ZIP**, and unzip it anywhere (e.g. Documents).
  33. 2. **Double-click `INSTALL.bat`** and follow it. It asks your language first (English / Español).
  34. - If Windows says "Windows protected your PC": **More info → Run anyway**.
  35. - It installs Node.js and Git if they're missing, then opens your browser to sign in to Cloudflare.
  36. - You'll choose a password for your memory. Write it down.
  37. 3. At the end, **`GUIDE.html`** opens with the exact clicks to connect Claude and ChatGPT (~5 minutes).
  38. **Even easier — let Claude do it:** open the Claude desktop app, connect this folder, and write
  39. *"Read CLAUDE-SETUP.md and set everything up for me."* Claude runs the steps and tells you where to
  40. click; your password never passes through the chat.
  41. The installer can be re-run at any time: it resumes and never deletes anything.
  42. ## How it works
  43. ```
  44. Claude ──┐
  45. ├── MCP + OAuth (your password) ──► your Cloudflare Worker
  46. ChatGPT ─┘ ├─ D1: documents + revision history
  47. ├─ KV: login sessions
  48. └─ optional mirror → your private GitHub repo
  49. your code folder ── git hook · deploy hook · hourly scan ──► activity log (UNRECORDED WORK)
  50. ```
  51. - **Server:** a TypeScript Cloudflare Worker (`server/`) using the MCP SDK and
  52. `@cloudflare/workers-oauth-provider`. Documents are Markdown files with paths like
  53. `/projects/my-app.md`, stored in D1.
  54. - **Tools the assistants get:** `memory_list`, `memory_read`, `memory_search`, `memory_recent`,
  55. `memory_write`, `memory_append`, `memory_str_replace`, `memory_delete`, `journal_add`,
  56. `memory_history`, `memory_revision`, `memory_restore`, `memory_diagnostics`, `memory_sync`,
  57. `memory_guide`.
  58. - **Behaviour rules** for the assistants live in `server/src/instructions.ts` and are sent with
  59. every connection: read first, write before finishing each turn, tag facts as `[stated]` or
  60. `[assumed]` (with evidence), never store sensitive categories, treat stored text as data rather
  61. than instructions.
  62. - **Client hooks** (`client/`) report commits, deploys and file changes from your code folder.
  63. - **Tests:** `cd server && npm ci && npm run typecheck && npm test` (45 regression tests).
  64. ### Manual install (any OS, for developers)
  65. ```sh
  66. cd server && npm ci
  67. npx wrangler login
  68. npx wrangler d1 create ai-memory
  69. npx wrangler kv namespace create ai-memory-oauth
  70. cp wrangler.template.jsonc wrangler.jsonc # fill in __WORKER_NAME__, __DB_NAME__, __D1_ID__, __KV_ID__, __GITHUB_REPO__ ("" for none)
  71. grep -rl '{{OWNER}}' src seed | xargs sed -i 's/{{OWNER}}/YourName/g'
  72. npx wrangler d1 execute ai-memory --remote --file=./schema.sql
  73. npx wrangler secret put ACCESS_PASSWORD # also FORM_TOKEN_SECRET and INGEST_TOKEN (long random strings)
  74. npx wrangler deploy
  75. node scripts/seed.mjs https://<your-worker>.workers.dev <password> seed
  76. ```
  77. Then add `https://<your-worker>.workers.dev/mcp` as a custom connector in Claude and ChatGPT
  78. (steps in `installer/GUIDE.template.html`) and paste `client/INSTRUCTIONS-TEXT.txt` into each
  79. assistant's custom instructions.
  80. ## How it was built
  81. A personal project, built with AI coding assistants (Claude and ChatGPT) — and then used by those
  82. same assistants every day to hand work back and forth. Hardening that came from real use includes
  83. atomic compare-and-swap writes, per-write revision tokens, HMAC-signed login form tokens, a
  84. secret-rejecting write guard, and server-side activity tracking.
  85. ## License
  86. [GPL-3.0](LICENSE) © 2026 FrozenFrostFox. You can use, change and share it; versions you
  87. distribute must stay open source under the same license.

Ratings and comments

Sign in to rate this skill.

Sign in

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