![\"amem\"](\"assets/logo.png\"){kind=logo}
\n\n \n
\n The memory layer for AI coding tools.
\n Tell your AI once β it remembers everywhere.\n
\n ![\"npm\"](\"https://img.shields.io/npm/v/@aman_asmuei/amem?style=flat-square&logo=npm&logoColor=white&color=cb3837\")
![\"CI\"](\"https://img.shields.io/github/actions/workflow/status/amanasmuei/amem/ci.yml?style=flat-square&logo=github&label=CI\")
![\"MIT\"](\"https://img.shields.io/badge/license-MIT-blue?style=flat-square\"){kind=icon}
![\"MCP\"](\"https://img.shields.io/badge/MCP-compatible-8A2BE2?style=flat-square\"){kind=icon}
![\"Node](\"https://img.shields.io/badge/node-%E2%89%A518-brightgreen?style=flat-square&logo=node.js&logoColor=white\"){kind=icon}
\n Quick Start Β· \n How It Works Β· \n Benchmarks Β· \n Tools Β· \n Dashboard Β· \n Architecture\n
\n\n---\n\n## π‘ The Problem\n\nEvery AI tool starts from zero. Every session. Every tool.\n\n```diff\n- You: \"Don't use 'any' in TypeScript\" β told Claude 3 times. Copilot still doesn't know.\n- You: \"We chose PostgreSQL over MongoDB\" β explained in Cursor. Claude has no idea.\n+ With amem: tell it once, every AI tool remembers β forever.\n```\n\n| \n\n**Claude Code** (recommended)\n\n```bash\n/plugin marketplace add amanasmuei/amem\n/plugin install amem\n```\n\n | \n\n\n**GitHub Copilot CLI**\n\n```bash\ncopilot plugin marketplace add amanasmuei/amem\ncopilot plugin install amem\n```\n\n | \n
| \n\n**LongMemEval-S (session-level) β headline metric**\n\n| Metric | Score |\n|:---:|:---:|\n| **R@1** | **95.0%** |\n| **R@3** | **97.0%** |\n| **R@5** | **π 97.8%** |\n| **R@10** | **99.0%** |\n\n500 questions Β· CPU only Β· zero API calls\n\n | \n\n\n**LongMemEval Oracle (turn-level)**\n\n| Metric | Score |\n|:---:|:---:|\n| **R@1** | **66.2%** |\n| **R@3** | **90.8%** |\n| **R@5** | **94.6%** |\n| **R@10** | **97.5%** |\n\n479 scoreable questions Β· 301s runtime Β· Node 22\n\n | \n
| \n\n**Full recall pipeline (v0.5.1+)**\n\n| Stage | p50 | Share |\n|---|---|---|\n| Embed (bi-encoder) | 3.0ms | 22% |\n| Retrieve (HNSW + multi-strategy) | 0.1ms | 1% |\n| **Rerank (int8 cross-encoder)** | **10.3ms** | **74%** |\n| **Total** | **~14ms** | 100% |\n\n | \n\n\n**HNSW index only (vector search)**\n\n| Memories | HNSW | Brute-force | Speedup |\n|---|---|---|---|\n| 100 | 0.05ms | 0.10ms | 2x |\n| 1,000 | 0.06ms | 0.50ms | **8x** |\n| 5,000 | 0.08ms | 2.44ms | **30x** |\n| 10,000 | 0.08ms | 5.35ms | **67x** |\n\n | \n\n\nMeasured: 100 searches averaged, 384-dim embeddings, top-10 results.\n\n**Sub-0.1ms at any scale** β effectively O(log n). HNSW is an optional dependency; brute-force is used as fallback when unavailable.\n\n | \n
| \n\n**Natural language** (easiest)\n\n```\n\"Remember: we use PostgreSQL, not MongoDB\"\n\"Store a correction: never use console.log in production\"\n\"Note that the auth module is in src/auth/\"\n```\n\n | \n\n\n**Explicit tool calls**\n\n```js\nmemory_store({\n content: \"Never use 'any' β define proper interfaces\",\n type: \"correction\",\n tags: [\"typescript\"],\n confidence: 1.0\n})\n```\n\n | \n
\n Built with β€οΈ in π²πΎ Malaysia by Aman Asmuei\n
\n\n\n ![\"GitHub\"](\"https://img.shields.io/badge/GitHub-repo-181717?style=flat-square&logo=github\"){kind=icon}
![\"npm\"](\"https://img.shields.io/badge/npm-package-cb3837?style=flat-square&logo=npm&logoColor=white\"){kind=icon}
![\"Issues\"](\"https://img.shields.io/badge/Issues-report-orange?style=flat-square&logo=github\"){kind=icon}
\n MIT License Β· Star β if amem saves your AI from amnesia\n
\n","readmeFilename":"README.md"}