From c6708b3684a7214a34f7c2e9b55f7f15945bc309 Mon Sep 17 00:00:00 2001 From: Alex Newman Date: Wed, 3 Dec 2025 21:47:59 -0500 Subject: [PATCH] Release v6.5.0: Documentation Overhaul MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Comprehensive documentation update with current features: - Updated "What's New" section to highlight v6.4.x features - Added privacy tags and context configuration to key features - Fixed default model (claude-haiku-4-5) - Clarified lifecycle hook count (5 events, 6 scripts) - Removed outdated MCP server references - Updated version numbers across all docs ๐Ÿค– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .claude-plugin/marketplace.json | 2 +- CLAUDE.md | 2 +- README.md | 35 +++++++++++---------- docs/public/configuration.mdx | 10 +++--- docs/public/installation.mdx | 1 - docs/public/introduction.mdx | 27 ++++++++-------- package.json | 2 +- plugin/.claude-plugin/plugin.json | 2 +- plugin/skills/mem-search/operations/help.md | 10 ++---- 9 files changed, 43 insertions(+), 48 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index dd4f6ef6..d4ece368 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -10,7 +10,7 @@ "plugins": [ { "name": "claude-mem", - "version": "6.4.9", + "version": "6.5.0", "source": "./plugin", "description": "Persistent memory system for Claude Code - context compression across sessions" } diff --git a/CLAUDE.md b/CLAUDE.md index 1e650e4b..3e017b7f 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -6,7 +6,7 @@ Claude-mem is a Claude Code plugin providing persistent memory across sessions. It captures tool usage, compresses observations using the Claude Agent SDK, and injects relevant context into future sessions. -**Current Version**: 6.4.9 +**Current Version**: 6.5.0 ## Architecture diff --git a/README.md b/README.md index 37b75433..8e73e968 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,7 @@ License - Version + Version Node @@ -71,6 +71,8 @@ Restart Claude Code. Context from previous sessions will automatically appear in - ๐Ÿ“Š **Progressive Disclosure** - Layered memory retrieval with token cost visibility - ๐Ÿ” **Skill-Based Search** - Query your project history with mem-search skill (~2,250 token savings) - ๐Ÿ–ฅ๏ธ **Web Viewer UI** - Real-time memory stream at http://localhost:37777 +- ๐Ÿ”’ **Privacy Control** - Use `` tags to exclude sensitive content from storage +- โš™๏ธ **Context Configuration** - Fine-grained control over what context gets injected - ๐Ÿค– **Automatic Operation** - No manual intervention required - ๐Ÿ”— **Citations** - Reference past decisions with `claude-mem://` URIs - ๐Ÿงช **Beta Channel** - Try experimental features like Endless Mode via version switching @@ -144,7 +146,7 @@ npx mintlify dev **Core Components:** -1. **6 Lifecycle Hooks** - context-hook, user-message-hook, new-hook, save-hook, summary-hook, cleanup-hook +1. **5 Lifecycle Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts) 2. **Smart Install** - Cached dependency checker (pre-hook script, not a lifecycle hook) 3. **Worker Service** - HTTP API on port 37777 with web viewer UI and 10 search endpoints, managed by PM2 4. **SQLite Database** - Stores sessions, observations, summaries with FTS5 full-text search @@ -229,28 +231,27 @@ See [Beta Features Documentation](https://docs.claude-mem.ai/beta-features) for --- -## What's New in v6.0.0 +## What's New -**๐Ÿš€ Major Session Management & Transcript Processing Improvements:** +**v6.4.9 - Context Configuration Settings:** +- 11 new settings for fine-grained control over context injection +- Configure token economics display, observation filtering by type/concept +- Control number of observations and which fields to display -- **Enhanced Session Initialization**: Accept userPrompt and promptNumber for better context tracking -- **Live UserPrompt Updates**: Multi-turn conversation support with real-time prompt tracking -- **Improved SessionManager**: Better context handling and observation processing -- **Comprehensive Transcript Processing**: New scripts and utilities for analyzing Claude Code transcripts -- **Rich Context Extraction**: Advanced parsing utilities for extracting meaningful context from sessions -- **Refactored Architecture**: Improved hooks and SDKAgent for more reliable observation handling -- **Silent Debug Logging**: Better debugging capabilities without cluttering output -- **Enhanced Error Handling**: More robust error recovery and debugging tools +**v6.4.0 - Dual-Tag Privacy System:** +- `` tags for user-controlled privacy - wrap sensitive content to exclude from storage +- System-level `` tags prevent recursive observation storage +- Edge processing ensures private content never reaches database -**Breaking Changes**: Significant architectural changes in session management and observation handling. Existing sessions continue to work, but internal APIs have evolved. +**v6.3.0 - Version Channel:** +- Switch between stable and beta versions from the web viewer UI +- Try experimental features like Endless Mode without manual git operations **Previous Highlights:** - +- **v6.0.0**: Major session management & transcript processing improvements - **v5.5.0**: mem-search skill enhancement with 100% effectiveness rate - **v5.4.0**: Skill-based search architecture (~2,250 tokens saved per session) -- **v5.1.2**: Theme toggle for light/dark mode in viewer UI - **v5.1.0**: Web-based viewer UI with real-time updates -- **v5.0.3**: Smart install caching (2-5s โ†’ 10ms) - **v5.0.0**: Hybrid search with Chroma vector database See [CHANGELOG.md](CHANGELOG.md) for complete version history. @@ -313,7 +314,7 @@ See [CHANGELOG.md](CHANGELOG.md) for complete version history. **Environment Variables:** -- `CLAUDE_MEM_MODEL` - AI model for processing (default: claude-sonnet-4-5) +- `CLAUDE_MEM_MODEL` - AI model for processing (default: claude-haiku-4-5) - `CLAUDE_MEM_WORKER_PORT` - Worker port (default: 37777) - `CLAUDE_MEM_DATA_DIR` - Data directory override (dev only) diff --git a/docs/public/configuration.mdx b/docs/public/configuration.mdx index f91af2e0..bfe2405a 100644 --- a/docs/public/configuration.mdx +++ b/docs/public/configuration.mdx @@ -13,7 +13,7 @@ description: "Environment variables and settings for Claude-Mem" | `CLAUDE_MEM_DATA_DIR` | `~/.claude-mem/` | Data directory (production default) | | `CLAUDE_CODE_PATH` | Auto-detected | Path to Claude Code CLI (for Windows) | | `CLAUDE_MEM_WORKER_PORT` | `37777` | Worker service port | -| `CLAUDE_MEM_MODEL` | `claude-sonnet-4-5` | AI model for processing observations | +| `CLAUDE_MEM_MODEL` | `claude-haiku-4-5` | AI model for processing observations | | `CLAUDE_MEM_CONTEXT_OBSERVATIONS` | `50` | Number of observations to inject | | `NODE_ENV` | `production` | Environment mode | | `FORCE_COLOR` | `1` | Enable colored logs | @@ -24,8 +24,8 @@ Configure which AI model processes your observations. ### Available Models -- `claude-haiku-4-5` - Fast, cost-efficient -- `claude-sonnet-4-5` - Balanced (default) +- `claude-haiku-4-5` - Fast, cost-efficient (default) +- `claude-sonnet-4-5` - Balanced - `claude-opus-4` - Most capable - `claude-3-7-sonnet` - Alternative version @@ -43,7 +43,7 @@ Edit `~/.claude/settings.json`: ```json { - "CLAUDE_MEM_MODEL": "claude-sonnet-4-5" + "CLAUDE_MEM_MODEL": "claude-haiku-4-5" } ``` @@ -328,7 +328,7 @@ npm run worker:logs ### Invalid Model Name -If you specify an invalid model name, the worker will fall back to `claude-sonnet-4-5` and log a warning. +If you specify an invalid model name, the worker will fall back to `claude-haiku-4-5` and log a warning. Valid models: - claude-haiku-4-5 diff --git a/docs/public/installation.mdx b/docs/public/installation.mdx index ca68c56a..296cbd98 100644 --- a/docs/public/installation.mdx +++ b/docs/public/installation.mdx @@ -18,7 +18,6 @@ That's it! The plugin will automatically: - Download prebuilt binaries (no compilation needed) - Install all dependencies (including PM2 and SQLite binaries) - Configure hooks for session lifecycle management -- Set up the MCP search server - Auto-start the worker service on first session Start a new Claude Code session and you'll see context from previous sessions automatically loaded. diff --git a/docs/public/introduction.mdx b/docs/public/introduction.mdx index 780e5a8b..f75ae6e6 100644 --- a/docs/public/introduction.mdx +++ b/docs/public/introduction.mdx @@ -25,7 +25,8 @@ Restart Claude Code. Context from previous sessions will automatically appear in - ๐Ÿง  **Persistent Memory** - Context survives across sessions - ๐Ÿ” **mem-search Skill** - Query your project history with natural language (~2,250 token savings) - ๐ŸŒ **Web Viewer UI** - Real-time memory stream visualization at http://localhost:37777 -- ๐ŸŽจ **Theme Toggle** - Light, dark, and system preference themes +- ๐Ÿ”’ **Privacy Control** - Use `` tags to exclude sensitive content from storage +- โš™๏ธ **Context Configuration** - Fine-grained control over what context gets injected - ๐Ÿค– **Automatic Operation** - No manual intervention required - ๐Ÿ“Š **FTS5 Search** - Fast full-text search across observations - ๐Ÿ”— **Citations** - Reference past decisions with `claude-mem://` URIs @@ -55,7 +56,7 @@ Restart Claude Code. Context from previous sessions will automatically appear in ``` **Core Components:** -1. **6 Lifecycle Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd, UserMessage +1. **5 Lifecycle Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts) 2. **Smart Install** - Cached dependency checker (pre-hook script) 3. **Worker Service** - HTTP API on port 37777 managed by PM2 4. **SQLite Database** - Stores sessions, observations, summaries with FTS5 search @@ -71,25 +72,23 @@ See [Architecture Overview](architecture/overview) for details. - **PM2**: Process manager (bundled - no global install required) - **SQLite 3**: For persistent storage (bundled) -## What's New in v6.0.0 +## What's New -**๐Ÿš€ Major Session Management & Transcript Processing Improvements:** +**v6.4.9 - Context Configuration Settings:** +- 11 new settings for fine-grained control over context injection +- Configure token economics display, observation filtering by type/concept -- **Enhanced Session Initialization**: Accept userPrompt and promptNumber for better context tracking -- **Live UserPrompt Updates**: Multi-turn conversation support with real-time prompt tracking -- **Improved SessionManager**: Better context handling and observation processing -- **Comprehensive Transcript Processing**: New scripts and utilities for analyzing Claude Code transcripts -- **Rich Context Extraction**: Advanced parsing utilities for extracting meaningful context from sessions -- **Refactored Architecture**: Improved hooks and SDKAgent for more reliable observation handling -- **Silent Debug Logging**: Better debugging capabilities without cluttering output -- **Enhanced Error Handling**: More robust error recovery and debugging tools +**v6.4.0 - Dual-Tag Privacy System:** +- `` tags for user-controlled privacy - wrap sensitive content to exclude from storage +- Edge processing ensures private content never reaches database -**Breaking Changes**: Significant architectural changes in session management and observation handling. Existing sessions continue to work, but internal APIs have evolved. +**v6.3.0 - Version Channel:** +- Switch between stable and beta versions from the web viewer UI **Previous Highlights:** +- **v6.0.0**: Major session management & transcript processing improvements - **v5.5.0**: mem-search skill enhancement with 100% effectiveness rate - **v5.4.0**: Skill-based search architecture (~2,250 tokens saved per session) -- **v5.1.2**: Theme toggle for light/dark mode in viewer UI ## Next Steps diff --git a/package.json b/package.json index 09f6bb10..00b415db 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "claude-mem", - "version": "6.4.9", + "version": "6.5.0", "description": "Memory compression system for Claude Code - persist context across sessions", "keywords": [ "claude", diff --git a/plugin/.claude-plugin/plugin.json b/plugin/.claude-plugin/plugin.json index 2e8c5a91..7d488d73 100644 --- a/plugin/.claude-plugin/plugin.json +++ b/plugin/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "claude-mem", - "version": "6.4.9", + "version": "6.5.0", "description": "Persistent memory system for Claude Code - seamlessly preserve context across sessions", "author": { "name": "Alex Newman" diff --git a/plugin/skills/mem-search/operations/help.md b/plugin/skills/mem-search/operations/help.md index 93bf04df..352b6f3f 100644 --- a/plugin/skills/mem-search/operations/help.md +++ b/plugin/skills/mem-search/operations/help.md @@ -21,7 +21,7 @@ Returns complete API documentation: ```json { - "version": "5.4.0", + "version": "6.5.0", "base_url": "http://localhost:37777/api", "endpoints": [ { @@ -55,7 +55,7 @@ Returns complete API documentation: Present as reference documentation: ```markdown -## claude-mem Search API Reference (v5.4.0) +## claude-mem Search API Reference Base URL: `http://localhost:37777/api` @@ -164,11 +164,7 @@ The help response includes version information: ```json { - "version": "5.4.0", - "skill_migration": true, - "deprecated": { - "mcp_tools": "Replaced by HTTP API in v5.4.0" - } + "version": "6.5.0" } ```