diff --git a/salesflow-saas/CLAUDE.md b/salesflow-saas/CLAUDE.md index 6730f181..19d8a022 100644 --- a/salesflow-saas/CLAUDE.md +++ b/salesflow-saas/CLAUDE.md @@ -86,3 +86,15 @@ Before writing code, classify your task: - Always detect dialect before processing (saudi/gulf/msa) - Check for Arabizi and suggest Arabic conversion - Check code-switching (Arabic+English mixed) for readability + +## claude-mem (Persistent Memory) + +Installed and active. Automatically captures every session's work and injects context into new sessions. + +- **Worker**: `npx claude-mem start` (port 37777) +- **Web UI**: http://localhost:37777 +- **Search**: Use `/mem-search` in Claude Code +- **Data**: `~/.claude-mem/claude-mem.db` (SQLite + Chroma vectors) +- **Privacy**: Wrap sensitive content in `...` tags +- **Token savings**: ~95% reduction via 3-layer progressive retrieval +- **Auto-captures**: tool executions, session summaries, decisions, bugs, patterns diff --git a/salesflow-saas/memory/patterns/claude-mem-integration.md b/salesflow-saas/memory/patterns/claude-mem-integration.md new file mode 100644 index 00000000..06d867f0 --- /dev/null +++ b/salesflow-saas/memory/patterns/claude-mem-integration.md @@ -0,0 +1,68 @@ +# 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 `...` 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