\n \n
![\"Claude-Mem\"](\"https://raw.githubusercontent.com/bjlee2024/claude-mem/main/docs/public/claude-mem-logo-for-light-mode.webp\"){kind=logo}
\n \n
\n \n ๐จ๐ณ ไธญๆ โข\n ๐น๐ผ ็น้ซไธญๆ โข\n ๐ฏ๐ต ๆฅๆฌ่ช โข\n ๐ต๐น Portuguรชs โข\n ๐ง๐ท Portuguรชs โข\n ๐ฐ๐ท ํ๊ตญ์ด โข\n ๐ช๐ธ Espaรฑol โข\n ๐ฉ๐ช Deutsch โข\n ๐ซ๐ท Franรงais โข\n ๐ฎ๐ฑ ืขืืจืืช โข\n ๐ธ๐ฆ ุงูุนุฑุจูุฉ โข\n ๐ท๐บ ะ ัััะบะธะน โข\n ๐ต๐ฑ Polski โข\n ๐จ๐ฟ ฤeลกtina โข\n ๐ณ๐ฑ Nederlands โข\n ๐น๐ท Tรผrkรงe โข\n ๐บ๐ฆ ะฃะบัะฐัะฝััะบะฐ โข\n ๐ป๐ณ Tiแบฟng Viแปt โข\n ๐ต๐ญ Tagalog โข\n ๐ฎ๐ฉ Indonesia โข\n ๐น๐ญ เนเธเธข โข\n ๐ฎ๐ณ เคนเคฟเคจเฅเคฆเฅ โข\n ๐ง๐ฉ เฆฌเฆพเฆเฆฒเฆพ โข\n ๐ต๐ฐ ุงุฑุฏู โข\n ๐ท๐ด Romรขnฤ โข\n ๐ธ๐ช Svenska โข\n ๐ฎ๐น Italiano โข\n ๐ฌ๐ท ฮฮปฮปฮทฮฝฮนฮบฮฌ โข\n ๐ญ๐บ Magyar โข\n ๐ซ๐ฎ Suomi โข\n ๐ฉ๐ฐ Dansk โข\n ๐ณ๐ด Norsk\n
\n\n\n \n ![\"License\"](\"https://img.shields.io/badge/License-Apache%202.0-blue.svg\"){kind=icon}
\n \n \n ![\"Version\"](\"https://img.shields.io/badge/version-6.5.0-green.svg\"){kind=icon}
\n \n \n ![\"Node\"](\"https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg\"){kind=icon}
\n \n \n ![\"Mentioned](\"https://awesome.re/mentioned-badge.svg\"){kind=icon}
\n \n
\n \n ![\"bjlee2024/claude-mem](\"https://raw.githubusercontent.com/bjlee2024/claude-mem/main/docs/public/trendshift-badge.svg\"){kind=icon}
\n
| \n \n | \n \n \n | \n
\n Quick Start โข\n How It Works โข\n Search Tools โข\n Documentation โข\n Configuration โข\n Troubleshooting โข\n License\n
\n\n\n Claude-Mem seamlessly preserves context across sessions by automatically capturing tool usage observations, generating semantic summaries, and making them available to future sessions. This enables Claude to maintain continuity of knowledge about projects even after sessions end or reconnect.\n
\n\n---\n\n## Quick Start\n\n> ๐ด This is the **`@bjlee2024/claude-mem`** fork โ install from this package (not the upstream `claude-mem`). See the **[Fork Guide](docs/FORK.md)** for what differs.\n\n### Default โ local memory on one machine\n\nInstall with a single command:\n\n```bash\nnpx @bjlee2024/claude-mem install\n```\n\nOr install for Gemini CLI (auto-detects `~/.gemini`) / OpenCode / Grok:\n\n```bash\nnpx @bjlee2024/claude-mem install --ide gemini-cli\nnpx @bjlee2024/claude-mem install --ide opencode\nnpx @bjlee2024/claude-mem install --ide grok\n```\n\nOr install from the plugin marketplace inside Claude Code:\n\n```bash\n/plugin marketplace add bjlee2024/claude-mem\n\n/plugin install claude-mem\n```\n\nRestart Claude Code or Gemini CLI. Context from previous sessions will automatically appear in new sessions.\n\n### Server & Client modes โ shared memory across devices\n\n> **Fork feature.** Run one **server** (Postgres + Valkey, in Docker) and connect any number of thin **clients** โ laptop, desktop, and the server box itself โ that share **one memory pool** over a trusted network (e.g. Tailscale). **Clients never need a provider API key**: generation runs on the server (a Claude Code subscription or a local Ollama model). Requires the `server-beta` runtime.\n\n**1. On the server box** โ set up the server stack:\n\n```bash\nnpx @bjlee2024/claude-mem install --mode server\n```\n\n**2. Enroll each device** โ on the server (where `CLAUDE_MEM_SERVER_DATABASE_URL` reaches Postgres), mint a one-time token using the address other devices can reach (your tailnet IP, **not** `127.0.0.1`):\n\n```bash\nnpx @bjlee2024/claude-mem server enroll --url http://100.x.y.z:37877 --label laptop\n```\n\n**3. On each client device** โ redeem the token:\n\n```bash\nnpx @bjlee2024/claude-mem install --mode client --enroll