system-prompts-and-models-o.../salesflow-saas/memory/patterns/claude-mem-integration.md
Claude ce13ee2c46
feat: Install and integrate claude-mem persistent memory system
Installed claude-mem v12.1.0 — persistent memory compression for Claude Code:
- Automatically captures every session's work
- Compresses observations using AI (95% token reduction)
- 3-layer progressive retrieval (search → timeline → full)
- Worker running on port 37777
- SQLite + Chroma vector search for hybrid retrieval
- Updated CLAUDE.md with claude-mem section
- Added integration documentation to memory/patterns/

https://claude.ai/code/session_01LsnvBa7HwF5hs99VZbgLGj
2026-04-11 10:02:46 +00:00

69 lines
2.3 KiB
Markdown

# claude-mem Integration — Dealix AI Revenue OS
**Date**: 2026-04-11 | **Status**: active | **Version**: 12.1.0
## What It Does
claude-mem automatically captures everything that happens during Claude Code sessions, compresses it using AI, and injects relevant context into future sessions. This gives the project **persistent memory across sessions**.
## How It Works
1. **SessionStart** → injects context from previous sessions (50 observations from last 10 sessions)
2. **UserPromptSubmit** → captures your prompts
3. **PostToolUse** → every tool execution generates a compressed observation
4. **Stop** → generates session summary (request, investigated, learned, completed, next steps)
5. **SessionEnd** → finalizes the session
## 3-Layer Token Retrieval
| Layer | What | Cost |
|-------|------|------|
| `search` | Compact index of titles/dates/types | ~50-100 tokens/result |
| `timeline` | Chronological context around observation | ~100-200 tokens/result |
| `get_observations` | Full observation records | ~500-1000 tokens/result |
This progressive approach saves ~10x tokens by filtering before fetching.
## Commands
```bash
npx claude-mem start # Start worker
npx claude-mem stop # Stop worker
npx claude-mem status # Check status
npx claude-mem install # Reinstall/update
```
In Claude Code: `/mem-search` to search past work
## Configuration
Settings at `~/.claude-mem/settings.json`:
- `CLAUDE_MEM_MODEL`: sonnet (default)
- `CLAUDE_MEM_CONTEXT_OBSERVATIONS`: 50
- `CLAUDE_MEM_CONTEXT_SESSION_COUNT`: 10
- `CLAUDE_MEM_PROVIDER`: claude
## Data Location
```
~/.claude-mem/
├── claude-mem.db # SQLite database
├── settings.json # Configuration
├── chroma/ # Vector embeddings
└── logs/ # Worker logs
```
## Privacy
Wrap sensitive content in `<private>...</private>` tags to prevent storage.
## Integration with Dealix
claude-mem works as a global Claude Code plugin. It automatically hooks into ALL sessions regardless of project. No per-project configuration needed.
Benefits for Dealix:
- Remembers architecture decisions across sessions
- Tracks bugs fixed and patterns discovered
- Preserves context about Saudi market learnings
- Reduces token usage by ~95% for repeated context