{"_id":"@alucardeht/claude-memory","_rev":"6-5db44662ea156a5c672d430900effa2e","name":"@alucardeht/claude-memory","dist-tags":{"latest":"2.0.1"},"versions":{"1.0.0":{"name":"@alucardeht/claude-memory","version":"1.0.0","keywords":["claude","claude-code","memory","context","ai","llm"],"author":{"name":"Your Name"},"license":"MIT","_id":"@alucardeht/claude-memory@1.0.0","maintainers":[{"name":"alucardeht","email":"juliolena25@gmail.com"}],"homepage":"https://github.com/alucardeht/claude-memory#readme","bugs":{"url":"https://github.com/alucardeht/claude-memory/issues"},"os":["darwin","linux","win32"],"bin":{"claude-memory":"bin/claude-memory"},"cpu":["x64","arm64"],"dist":{"shasum":"73253b7d471909515b59a6039f9bf80183b7d0a2","tarball":"https://registry.npmjs.org/@alucardeht/claude-memory/-/claude-memory-1.0.0.tgz","fileCount":3,"integrity":"sha512-bXtuxLa2Dqrn75U41n2jiCmTpG6DPiQzlXLJoLJD6irI7MLy+j1oJ9Z5C/I+99b9kLjvyoITPFdTjk/hmzmKAQ==","signatures":[{"sig":"MEYCIQDCAJOx3wc6C2r/CpOaIh/oammQ2AAcACRf41bbcE3ArwIhAOZ3p3DhEZXS0Y/bbsUlEKZ11XKUF3v0vPdwWoSeAl2j","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4332},"engines":{"node":">=14"},"gitHead":"8d7f864c2dccea7a9faa37f001e63da1da4161a7","scripts":{"postinstall":"node install.js"},"_npmUser":{"name":"alucardeht","email":"juliolena25@gmail.com"},"repository":{"url":"git+https://github.com/alucardeht/claude-memory.git","type":"git"},"_npmVersion":"10.9.4","description":"Automatic context persistence for Claude Code","directories":{},"_nodeVersion":"25.2.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/claude-memory_1.0.0_1766461271567_0.759633313948707","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."},"1.0.1":{"name":"@alucardeht/claude-memory","version":"1.0.1","keywords":["claude","claude-code","memory","context","ai","llm"],"author":{"name":"Your Name"},"license":"MIT","_id":"@alucardeht/claude-memory@1.0.1","maintainers":[{"name":"alucardeht","email":"juliolena25@gmail.com"}],"homepage":"https://github.com/alucardeht/claude-memory#readme","bugs":{"url":"https://github.com/alucardeht/claude-memory/issues"},"os":["darwin","linux","win32"],"bin":{"claude-memory":"bin/claude-memory"},"cpu":["x64","arm64"],"dist":{"shasum":"75dfa31a4e461b2c3b6df4f62c56725c62eebd7c","tarball":"https://registry.npmjs.org/@alucardeht/claude-memory/-/claude-memory-1.0.1.tgz","fileCount":3,"integrity":"sha512-tKbiZwZoJP7ObZvUOVjO/BM0W+B6Zb3BcoiDKuxb7Ss7/LO6/7azUP6eSOZFGZjgyn6YM4fSwElXo2Z0BaNYzw==","signatures":[{"sig":"MEYCIQD6zwsN35jENxtIrogXe37KosDPtFDrGZqUfrXo4xRFFQIhAO+XJgGZv6Ea9iCWuryM43ZoIWrOseZrBKUFkZfOvCIq","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4338},"engines":{"node":">=14"},"gitHead":"010e1da3703507e0d1b3c456c19ca41e391da4a8","scripts":{"postinstall":"node install.js"},"_npmUser":{"name":"alucardeht","email":"juliolena25@gmail.com"},"repository":{"url":"git+https://github.com/alucardeht/claude-memory.git","type":"git"},"_npmVersion":"10.9.4","description":"Automatic context persistence for Claude Code","directories":{},"_nodeVersion":"25.2.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/claude-memory_1.0.1_1766461430279_0.14329045192699108","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."},"1.0.3":{"name":"@alucardeht/claude-memory","version":"1.0.3","keywords":["claude","claude-code","memory","context","ai","llm"],"author":{"name":"Your Name"},"license":"MIT","_id":"@alucardeht/claude-memory@1.0.3","maintainers":[{"name":"alucardeht","email":"juliolena25@gmail.com"}],"homepage":"https://github.com/alucardeht/claude-memory#readme","bugs":{"url":"https://github.com/alucardeht/claude-memory/issues"},"os":["darwin","linux","win32"],"bin":{"claude-memory":"bin/claude-memory"},"cpu":["x64","arm64"],"dist":{"shasum":"4ccc8a15b035f686e04a76a8bd5d23fa1c3c9a56","tarball":"https://registry.npmjs.org/@alucardeht/claude-memory/-/claude-memory-1.0.3.tgz","fileCount":3,"integrity":"sha512-1P64anwE98G8kkisGQOCftzturBvLKGUfiYoj/LvUcpCPM63er1CPo794734pTe1gHIXkrv76B2C+gDJmlOwQQ==","signatures":[{"sig":"MEQCIG0KTK5LAznSuGTNYD+Tzg++68wiVy8satIkIeNQve4WAiAJhQRQn2WeDLoZdJojVpY/QhYfL45pGRauNxXPHhv79w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4338},"engines":{"node":">=14"},"gitHead":"495866b3805fac12385103e73be58d12b753e4bf","scripts":{"postinstall":"node install.js"},"_npmUser":{"name":"alucardeht","email":"juliolena25@gmail.com"},"repository":{"url":"git+https://github.com/alucardeht/claude-memory.git","type":"git"},"_npmVersion":"10.9.4","description":"Automatic context persistence for Claude Code","directories":{},"_nodeVersion":"25.2.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/claude-memory_1.0.3_1766464724170_0.5763831025542829","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."},"1.0.4":{"name":"@alucardeht/claude-memory","version":"1.0.4","keywords":["claude","claude-code","memory","context","ai","llm"],"author":{"name":"Your Name"},"license":"MIT","_id":"@alucardeht/claude-memory@1.0.4","maintainers":[{"name":"alucardeht","email":"juliolena25@gmail.com"}],"homepage":"https://github.com/alucardeht/claude-memory#readme","bugs":{"url":"https://github.com/alucardeht/claude-memory/issues"},"os":["darwin","linux","win32"],"bin":{"claude-memory":"bin/claude-memory"},"cpu":["x64","arm64"],"dist":{"shasum":"f83722ae32c87d3680a8b93f2b174f6c2f78630a","tarball":"https://registry.npmjs.org/@alucardeht/claude-memory/-/claude-memory-1.0.4.tgz","fileCount":3,"integrity":"sha512-m+Nt1xIi3tnm7ZFTrmFhULdcLc+KHYzIWppujCXn6OX1eVllYAKrwK6JqnR/CVkSry7/dwLxS5g1j5abU/iD/w==","signatures":[{"sig":"MEQCIH/DYBXD9N3GQ+h/RFVosOjm+BYW1TI0N8MlxQ8s8J2GAiAtdgXwV0tthhWMff78+G+aHScs2C646aq0KBGiPtkdzg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4338},"engines":{"node":">=14"},"gitHead":"3ec540a47eec6b339940adb41dd5cdc5934584fe","scripts":{"postinstall":"node install.js"},"_npmUser":{"name":"alucardeht","email":"juliolena25@gmail.com"},"repository":{"url":"git+https://github.com/alucardeht/claude-memory.git","type":"git"},"_npmVersion":"10.9.4","description":"Automatic context persistence for Claude Code","directories":{},"_nodeVersion":"25.2.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/claude-memory_1.0.4_1766473478392_0.11059145196681208","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."},"2.0.1":{"name":"@alucardeht/claude-memory","version":"2.0.1","keywords":["claude","claude-code","memory","context","ai","llm"],"author":{"name":"Your Name"},"license":"MIT","_id":"@alucardeht/claude-memory@2.0.1","maintainers":[{"name":"alucardeht","email":"juliolena25@gmail.com"}],"homepage":"https://github.com/alucardeht/claude-memory#readme","bugs":{"url":"https://github.com/alucardeht/claude-memory/issues"},"os":["darwin","linux","win32"],"bin":{"claude-memory":"bin/claude-memory"},"cpu":["x64","arm64"],"dist":{"shasum":"36fac803eef9bfa183c6397a12621d1b94471b28","tarball":"https://registry.npmjs.org/@alucardeht/claude-memory/-/claude-memory-2.0.1.tgz","fileCount":5,"integrity":"sha512-6YDqvLWBJYDXyqzxisXpSDvvFjRMTMiv/jtOEWxWJvcnce/qiIPm1FDqhbjXSItOzSEoHs8Al8t6lUaL7abvhw==","signatures":[{"sig":"MEUCIDCOv9EumufhnHzo7cNdI5yq2NKjr60p+UEcoQBigmUVAiEA+ascezSP+ujZncIRM3o5RC7i76toph/CJ0lHSGlo6yQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13495},"engines":{"node":">=14"},"gitHead":"4d6d12ffa2ef9abb63638d4ea82810037a307303","scripts":{"postinstall":"node install.js || true"},"_npmUser":{"name":"alucardeht","email":"juliolena25@gmail.com"},"repository":{"url":"git+https://github.com/alucardeht/claude-memory.git","type":"git"},"_npmVersion":"10.9.4","description":"Automatic context persistence for Claude Code","directories":{},"_nodeVersion":"25.2.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/claude-memory_2.0.1_1766716863793_0.9742656370205343","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."}},"time":{"created":"2025-12-23T03:41:11.434Z","modified":"2026-04-02T19:15:20.797Z","1.0.0":"2025-12-23T03:41:11.702Z","1.0.1":"2025-12-23T03:43:50.434Z","1.0.3":"2025-12-23T04:38:44.304Z","1.0.4":"2025-12-23T07:04:38.516Z","2.0.1":"2025-12-26T02:41:03.972Z"},"bugs":{"url":"https://github.com/alucardeht/claude-memory/issues"},"author":{"name":"Your Name"},"license":"MIT","homepage":"https://github.com/alucardeht/claude-memory#readme","keywords":["claude","claude-code","memory","context","ai","llm"],"repository":{"url":"git+https://github.com/alucardeht/claude-memory.git","type":"git"},"description":"Automatic context persistence for Claude Code","maintainers":[{"name":"alucardeht","email":"juliolena25@gmail.com"}],"readme":"# claude-memory\n\nAutomatic, invisible memory for Claude Code. Never lose context after `/compact` again.\n\n## What it does\n\nclaude-memory automatically:\n1. **Saves conversations** before `/compact` clears context\n2. **Injects relevant context** into every prompt based on what you're working on\n3. **Works invisibly** - install once, forget about it\n\n## Installation\n\n```bash\nnpm install -g @alucardeht/claude-memory\n```\n\n> **Note**: The `claude-memory install` command runs automatically after npm install.\n\nThat's it. The installer automatically:\n- Downloads the correct binary for your platform\n- Configures Claude Code hooks\n- Creates the memory database\n\n## How it works\n\n```\n┌─ Session Start ─────────────────────────────────┐\n│ Loads project core memory                       │\n│ → \"You're working on X, preferences are Y...\"   │\n└─────────────────────────────────────────────────┘\n                        ↓\n┌─ Every Prompt ──────────────────────────────────┐\n│ 1. Extracts entities (files, functions, errors) │\n│ 2. Searches for relevant past context           │\n│ 3. Injects as system message (~4000 tokens)     │\n│ Performance: <5ms total                         │\n└─────────────────────────────────────────────────┘\n                        ↓\n┌─ Before /compact ───────────────────────────────┐\n│ Saves entire conversation with importance scores│\n│ → Context preserved for future sessions         │\n└─────────────────────────────────────────────────┘\n```\n\n### What gets saved\n\nBoth your messages AND Claude's responses are saved, including:\n- Files and functions mentioned\n- Errors discussed\n- Decisions made\n\n### What gets injected\n\nOn each prompt, the system searches your past conversations and injects relevant context. Example of what Claude sees:\n\n```\n## Relevant History\n[user, 3 days ago]\nHow do I fix the auth bug?\nFiles: auth/login.go\n\n[assistant, 3 days ago]\nThe issue is in line 45, the token wasn't being validated...\nDecisions: Use JWT instead of sessions\n```\n\n### In practice\n\n- You mention `auth/login.go` → System finds past discussions about that file\n- You ask \"what was that bug?\" → System finds error-related conversations\n- You start fresh session → Claude already has context from days ago\n\n### Context Budget\n\nClaude-memory automatically manages context size to prevent token overflow:\n\n| Component | Token Budget | Max Size |\n|-----------|--------------|----------|\n| Core Memory | 500 tokens | ~2KB |\n| Retrieved Context | 3500 tokens | ~14KB |\n| **Total** | **4000 tokens** | **~16KB** |\n\n**Safety features:**\n- Automatic truncation when limits are exceeded\n- Warning logs via `slog` when approaching limits\n- Hard safety net at 20KB (user prompts) / 10KB (session start)\n\nThis is transparent and requires no configuration.\n\n### Privacy\n\nAll data stays local in `~/.claude-memory/`. No cloud, no sync, no network calls.\n\n## Commands\n\n```bash\n# Install hooks (done automatically on npm install)\nclaude-memory install\n\n# Uninstall hooks\nclaude-memory install --uninstall\n\n# Search your memory manually\nclaude-memory search \"auth bug\"\nclaude-memory search \"database migration\" --project /path/to/project\n\n# Show version\nclaude-memory --version\n```\n\n## Search options\n\n```bash\nclaude-memory search [query] [flags]\n\nFlags:\n  -n, --limit int      Maximum results (default 10)\n  -p, --project path   Search specific project\n  -s, --scores         Show relevance scores\n```\n\n## How scoring works\n\n| Content Type | Score Boost |\n|--------------|-------------|\n| File mentions (src/auth.go) | +3 |\n| Function mentions (validateToken) | +2 |\n| Error patterns | +3 |\n| Decision phrases (\"vamos usar\", \"let's use\") | +2 |\n| Short/filler messages (\"ok\", \"got it\") | -2 |\n\nRecency also matters:\n- Last hour: 2x boost\n- Last day: 1.5x boost\n- Last week: 1.2x boost\n- Older than month: 0.8x penalty\n\n## Storage\n\nMemory is stored in `~/.claude-memory/memory.db` (SQLite with FTS5).\n\nEach project has isolated memory based on its absolute path.\n\n## Performance\n\n| Operation | Target | Actual |\n|-----------|--------|--------|\n| Entity extraction | <1ms | ~170µs |\n| FTS search | <1ms | ~200µs |\n| Context injection | <5ms | ~160µs |\n| Session start | <1ms | ~30µs |\n\n## Requirements\n\n- Claude Code CLI\n- Node.js 16+ (for npm installation)\n- macOS, Linux, or Windows\n\n## Windows Support\n\nclaude-memory has full support for Windows 10 and Windows 11.\n\n### Installation (same as other platforms)\n\n```powershell\nnpm install -g @alucardeht/claude-memory\nclaude-memory install\n```\n\n### Windows-specific paths\n\n| Data | Location |\n|------|----------|\n| Claude settings | `%APPDATA%\\Claude\\settings.json` |\n| claude-memory database | `%APPDATA%\\claude-memory\\memory.db` |\n| claude-memory config | `%APPDATA%\\claude-memory\\config.json` |\n\n> **Note**: On Windows, `%APPDATA%` typically resolves to `C:\\Users\\YourUsername\\AppData\\Roaming\\`\n\n### Requirements for Windows\n\n- Node.js 16+ (download from [nodejs.org](https://nodejs.org))\n- Git for Windows (recommended, includes Git Bash)\n- Claude Code CLI installed and configured\n\n### Troubleshooting\n\nIf you encounter issues:\n\n1. **Binary not found**: Try reinstalling with `npm install -g @alucardeht/claude-memory`\n2. **Permission errors**: Run PowerShell/CMD as Administrator\n3. **Path issues**: Ensure `%APPDATA%\\npm` is in your system PATH\n\n## Uninstall\n\n```bash\nnpm uninstall -g @alucardeht/claude-memory\n```\n\nThis removes the CLI and hooks. Memory database remains in `~/.claude-memory/`.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}