Claude Mnemonic
Give Claude Code a memory that actually remembers.
Claude Code forgets everything when your session ends. Claude Mnemonic fixes that.
It captures what Claude learns during your coding sessions - bug fixes, architecture decisions, patterns that work - and brings that knowledge back in future conversations. No more re-explaining your codebase.
What's New in v0.7
- Two-Stage Retrieval - Cross-encoder reranking for dramatically improved search relevance
- Knowledge Graph - Automatic relationship detection between observations with visual graph in dashboard
- Pattern Detection - Identifies recurring patterns across sessions and projects
- Importance Scoring - Time decay and voting system to surface the most valuable memories
- Query Expansion - Reformulates searches to find semantically related content
- Conflict Detection - Identifies and resolves contradictory observations
- Observation Lifecycle - Memories can be superseded when better information arrives
Previous: v0.6
- Auto-Updates - Automatically stays up-to-date with the latest version
- Slash Command:
/restart - Restart the worker directly from Claude Code
- Local Embeddings - All semantic search runs locally via ONNX Runtime (no external API calls)
- Async Queue Processing - Non-blocking observation capture for faster sessions
- Smarter Storage - Filters out system/agent summaries to keep knowledge relevant
- Improved Reliability - Better handling of connectivity issues and dead connections
Requirements
| Dependency | Required | Purpose |
|---|
| Claude Code CLI | Yes | Host application (this is a plugin) |
| jq | Yes | JSON processing during installation |
That's it. No Python. No external services. Everything runs locally.
No API keys needed! Claude Mnemonic uses Claude Code CLI, which works with your existing Claude Pro or Max subscription. No separate API costs.
Install
One command. That's it.
curl -sSL https://raw.githubusercontent.com/lukaszraczylo/claude-mnemonic/main/scripts/install.sh | bash
Windows (PowerShell)
irm https://raw.githubusercontent.com/lukaszraczylo/claude-mnemonic/main/scripts/install.ps1 | iex
Build from source
git clone https://github.com/lukaszraczylo/claude-mnemonic.git
cd claude-mnemonic
make build && make install
Requires: Go 1.24+, Node.js 18+, CGO-compatible compiler
After install, open http://localhost:37777 to see the dashboard. Start a new Claude Code session - memory is now active.
Verifying Release Signatures
All release checksums are signed with cosign using keyless signing. To verify:
# Download the checksum file and its sigstore bundle from the release
cosign verify-blob \
--certificate-identity-regexp "https://github.com/lukaszraczylo/claude-mnemonic/.*" \
--certificate-oidc-issuer "https://token.actions.githubusercontent.com" \
--bundle "checksums.txt.sigstore.json" \
checksums.txt
What it does
| Feature | Description |
|---|
| Persistent Memory | Observations survive across sessions and restarts |
| Project Isolation | Each project has its own knowledge base |
| Global Patterns | Best practices are shared across all projects |
| Semantic Search | Find relevant context with natural language (local embeddings) |
| Live Statusline | Real-time metrics in Claude Code: `[mnemonic] ● served:42 |
| Web Dashboard | Browse and manage memories at localhost:37777 |
| Auto-Updates | Automatically downloads and applies new versions |
| Slash Commands | Control the worker directly from Claude Code |
How knowledge flows
You code with Claude
↓
Claude learns something useful
↓
Mnemonic captures it automatically
↓
Next session: Claude remembers
Behind the scenes: hooks capture Claude's observations → SQLite stores with full-text search → sqlite-vec enables semantic search with local embeddings (all-MiniLM-L6-v2) → relevant context is injected at session start.
Configuration
Config file: ~/.claude-mnemonic/settings.json
