Release v3.6.2

Published from npm package build
Source: https://github.com/thedotmack/claude-mem-source

.gitignore

@@ -4,4 +4,4 @@ node_modules/
 .env
 .env.local
 *.tmp
-*.temp
+*.temp

CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+
+## [3.6.2] - 2025-09-10
+
+### Added
+- Visual feedback to changelog command showing current version, next version, and number of overviews being processed
+- Generate changelog for specific versions using `--generate` flag with npm publish time boundaries
+
+### Changed
+- Changelog regeneration automatically removes old entries from JSONL file when using `--generate` or `--historical` flags
+
+### Fixed
+- Changelog command now uses npm publish timestamps exclusively for accurate version time ranges
+- Resolved timestamp filtering issues with Chroma database by leveraging semantic search with embedded dates
+
+
+## [3.6.1] - 2025-09-10
+
+### Changed
+- Refactored pre-compact hook to work independently without status line updates
+
+### Removed
+- Removed status line integration and ccstatusline configuration support
+
+
+## [3.5.5] - 2025-09-10
+
+### Changed
+- Standardized GitHub release naming to lowercase 'claude-mem vX.X.X' format for consistent branding
+

README.md

@@ -1,222 +1,114 @@
-# Claude Memory System (claude-mem)
+# 🧠 Claude Memory System (claude-mem)
 
-**Truth + Context = Clarity**
+## Remember that one thing? Neither do we… but `claude-mem` does! 😵‍💫
 
-A revolutionary memory system that transforms your Claude Code conversations into a persistent, intelligent knowledge base. Never lose valuable insights, code patterns, or debugging solutions again. Your AI assistant finally has a memory that spans across all your projects and sessions.
+Stop repeating yourself. `claude-mem` remembers what you and Claude Code figure out, so every new chat starts smarter than the last.
 
-## 🚀 Why Claude-Mem?
+## ⚡️ 10‑Second Setup
 
-### The Problem We Solve
-- **Lost Context**: Starting every Claude Code session from scratch
-- **Repeated Explanations**: Re-describing your codebase and architecture repeatedly  
-- **Fragmented Knowledge**: Valuable insights scattered across hundreds of conversations
-- **Context Switching**: Losing progress when switching between projects or devices
-- **Knowledge Decay**: Brilliant solutions forgotten and re-discovered multiple times
-
-### The Claude-Mem Solution
-Transform your Claude Code experience from forgetful to persistent, from isolated sessions to connected knowledge, from starting over to building upon previous insights.
-
-## ✨ Key Features
-
-### 🧠 **Intelligent Memory Compression**
-- Automatically extracts key learnings from your Claude Code conversations
-- Identifies patterns, architectural decisions, and breakthrough moments
-- Compresses hours of conversation into searchable, actionable knowledge
-- Uses advanced AI analysis to understand context and significance
-
-### 🔄 **Seamless Integration**
-- **One-command setup**: `claude-mem install` and you're ready
-- **Zero friction**: Works invisibly in the background
-- **Automatic triggers**: Memory compression on `/compact` and `/clear`
-- **Instant context loading**: New sessions start with relevant memories
-
-### 🎯 **Smart Context Loading**
-- Loads relevant memories when starting new sessions
-- Project-aware context selection
-- Semantic search finds related knowledge across all sessions
-- Prevents re-explaining the same concepts repeatedly
-
-### 📚 **Comprehensive Knowledge Base**
-- Stores technical implementations, bug fixes, and solutions
-- Captures design patterns and architectural decisions
-- Remembers tool configurations and setup procedures
-- Archives complete conversation transcripts for detailed reference
-
-### 🔍 **Powerful Search & Retrieval**
-- Vector-based semantic search finds related concepts
-- Keyword search for specific terms and technologies
-- Project filtering to focus on relevant memories
-- Time-based filtering to find recent insights
-
-## 🛠 Installation & Setup
-
-### Prerequisites
-- Node.js 18+ 
-- Claude Code CLI installed
-- uv (Python package manager) - automatically installed if missing
-
-### Quick Install
 ```bash
-# Install globally
-npm install -g claude-mem
-
-# Set up Claude Code integration (installs uv if needed)
-claude-mem install
-
-# Restart Claude Code to activate
+npm install -g claude-mem && claude-mem install
 ```
 
-### Alternative Installation
+That’s it. Restart Claude Code and you’re good. No config. No tedious setup or dependencies.
+
+## ✨ What You Get
+
+- Remembers key insights from your chats with Claude Code
+- Starts new sessions with the right context
+- Works quietly in the background
+- One-command install and status check
+- **🎭 Shakespeare's Memory Theatre**: Transform operations into theatrical magnificence!
+
+## 🎭 NEW: Shakespeare's Memory Theatre
+
+*"All the world's a stage, And all memory merely players"*
+
+Experience claude-mem operations as a dramatic performance! Choose from five theatrical acts:
+
 ```bash
-# Use without installing globally
-npx claude-mem install
+claude-mem theatre                    # Full theatrical experience
+claude-mem theatre --act I           # Tragedy of Defensive Validation
+claude-mem theatre --act II          # Romeo and Chroma_Add  
+claude-mem compress-theatrical file   # Compress with Shakespearean flair
+claude-mem status-theatrical          # Check status dramatically
 ```
 
-The `claude-mem install` command will automatically install [uv](https://docs.astral.sh/uv/) if it's not already present on your system. uv is required for the Chroma MCP server that powers the memory system.
+**Interactive Features:**
+- 🎪 Choose dialogue responses
+- 🍅 Throw tomatoes at bad code
+- 👏 Standing ovation meter
+- 📜 Soliloquy generator
+- 🎺 Trumpet fanfares
+
+[📖 Full Shakespeare Theatre Documentation](docs/shakespeare-theatre.md)
+
+## 🗑️ Smart Trash™ (Your Panic Button)
+
+Delete something by accident? It’s not gone.
+- Everything goes to `~/.claude-mem/trash/`
+- Restore with a single command: `claude-mem restore`
+- Timestamped so you can see when things moved
+
+## 🎯 Why It’s Useful
+
+- No more re-explaining your project over and over
+- Pick up exactly where you left off
+- Find past solutions fast when you face a familiar bug
+- Your knowledge compounds the more you use it
+
+## 🧭 Minimal Commands You’ll Ever Need
 
-### Verification
 ```bash
-# Check installation status
-claude-mem status
+claude-mem install          # Set up/repair integration
+claude-mem status           # Check everything’s working
+claude-mem load-context     # Peek at what it remembers
+claude-mem logs             # If you’re curious
+claude-mem uninstall        # Remove hooks
+
+# Extras
+claude-mem trash-view       # See what’s in Smart Trash™
+claude-mem restore          # Restore deleted items
+# 🎭 Shakespeare's Memory Theatre Commands
+claude-mem theatre          # Experience memory operations dramatically
+claude-mem compress-theatrical file.jsonl  # Theatrical compression
+claude-mem status-theatrical              # Dramatic status check
 ```
 
-## 💻 How It Works
-
-### The Memory Lifecycle
-
-1. **🎬 Session Start**: Claude-mem loads relevant context from your knowledge base
-2. **💬 Active Session**: You work normally in Claude Code - no changes needed
-3. **🗜️ Memory Compression**: Use `/compact` or `/clear` to trigger intelligent compression
-4. **🧠 Knowledge Extraction**: AI analysis extracts key learnings and patterns
-5. **💾 Persistent Storage**: Memories stored in searchable vector database
-6. **🔄 Context Ready**: Next session starts with relevant memories loaded
-
-### Technical Architecture
-
-- **Vector Database**: ChromaDB for semantic search and storage
-- **MCP Integration**: Model Context Protocol for Claude Code communication
-- **AI Analysis**: Advanced prompt engineering for knowledge extraction
-- **Local Storage**: All data stored locally in `~/.claude-mem/`
-
-## 📋 Commands Reference
-
-### Core Commands
-```bash
-claude-mem install          # Set up Claude Code integration
-claude-mem status           # Check system status and configuration
-claude-mem load-context     # View and search stored memories
-claude-mem logs             # View system logs and debug information
-claude-mem uninstall       # Remove Claude Code hooks
-```
-
-### Advanced Usage
-```bash
-claude-mem compress <file>  # Manually compress a transcript file
-claude-mem restore          # Restore from backups
-claude-mem trash-view       # View deleted files (Smart Trash feature)
-```
-
-## 📁 Storage Structure
-
-Your claude-mem data is organized in `~/.claude-mem/`:
+## 📁 Where Stuff Lives (super simple)
 
 ```
 ~/.claude-mem/
-├── index/           # ChromaDB vector database
-├── archives/        # Original conversation transcripts  
-├── hooks/           # Claude Code integration scripts
-├── trash/           # Smart Trash (deleted files)
-└── logs/            # System logs and debug information
+├── index/      # memory index
+├── archives/   # transcripts
+├── hooks/      # integration bits
+├── trash/      # Smart Trash™
+└── logs/       # diagnostics
 ```
 
-## 🌟 Real-World Benefits
+## ✅ Requirements
 
-### For Individual Developers
-- **Faster Problem Solving**: Find solutions you've used before instantly
-- **Knowledge Accumulation**: Build expertise that persists across projects
-- **Context Continuity**: Pick up where you left off, even weeks later
-- **Pattern Recognition**: See how you've solved similar problems before
+- Node.js 18+
+- Claude Code
 
-### For Teams (Coming Soon)
-- **Shared Knowledge**: Team-wide memory accessible to all members
-- **Onboarding Acceleration**: New team members access collective knowledge
-- **Best Practices**: Capture and share proven solutions
-- **Institutional Memory**: Prevent knowledge loss when team members leave
+## 🆘 If Something’s Weird
 
-## 🚀 Coming Soon: Cloud Sync
-
-### Individual Plan ($9.95/month)
-- **Multi-device sync**: Access your memories on any device
-- **Cloud backup**: Never lose your knowledge base
-- **Enhanced search**: Advanced filtering and semantic search
-- **API access**: Integrate with your own tools and workflows
-
-### Team Plan ($29.95/month, 3+ seats)
-- **Shared memories**: Team-wide knowledge base
-- **Role-based access**: Control what memories are shared
-- **Admin dashboard**: Manage team members and usage
-- **Priority support**: Direct access to our engineering team
-
-[**Join the waitlist**](https://claude-mem.ai) for early access to cloud features.
-
-## 🛡️ Privacy & Security
-
-- **Local-first**: All data stored locally by default
-- **No tracking**: We don't collect or transmit your conversations
-- **Your data**: You own and control your knowledge base
-- **Open architecture**: ChromaDB and MCP are open standards
-
-## 🆘 Troubleshooting
-
-### Common Issues
-
-**Hook not triggering?**
 ```bash
-claude-mem status    # Check installation
-claude-mem install --force   # Reinstall hooks
+claude-mem status           # quick health check
+claude-mem install --force  # fixes most issues
 ```
 
-**Context not loading?**
-```bash
-claude-mem load-context   # Verify memories exist
-claude-mem logs           # Check for errors
-```
-
-**Performance issues?**
-```bash
-# ChromaDB maintenance (if needed)
-claude-mem status    # Check memory usage
-```
-
-## 🔧 Requirements
-
-- **Node.js**: 18.0 or higher
-- **Claude Code**: Latest version recommended
-- **Storage**: ~100MB for typical usage
-- **Memory**: 2GB RAM minimum for large knowledge bases
-
-## 📞 Support & Community
-
-- **Documentation**: Complete guides at [claude-mem.ai/docs](https://claude-mem.ai/docs)
-- **Issues**: Report bugs at [GitHub Issues](https://github.com/thedotmack/claude-mem/issues)
-- **Feature Requests**: [GitHub Discussions](https://github.com/thedotmack/claude-mem/discussions)
-- **Community**: Join our [Discord](https://discord.gg/claude-mem) for tips and discussions
-
 ## 📄 License
 
-This software is free to use but is NOT open source. See [LICENSE](LICENSE) file for complete terms.
+This software is free to use but is NOT open source. See `LICENSE`.
 
 ---
 
-## 🎯 Ready to Transform Your Claude Code Experience?
+## Ready to remember more and repeat less?
 
 ```bash
 npm install -g claude-mem
 claude-mem install
 ```
 
-**Your AI assistant is about to get a lot smarter.** 🧠✨
-
----
-
-*Built with ❤️ for developers who believe AI assistants should remember and learn from every conversation.*
+Your future self will thank you. 🧠✨

commands/claude-mem.md

@@ -0,0 +1,23 @@
+---
+argument-hint: help | save [message] | remember [context] | (no args for help)
+description: Manage claude-mem operations and memory context
+allowed-tools: Bash(claude-mem:*), Bash(echo:*), Bash(cat:*)
+---
+
+## Claude-Mem Command Handler
+
+### Check for help command first
+!`[ -z "$ARGUMENTS" ] || [ "$ARGUMENTS" = "help" ] && printf '%s\n' '## 🧠 Claude-Mem Help' '' '**Available Commands:**' '' '• /claude-mem save [message] - Quick save of conversation overview' '• /claude-mem remember [query] - Search saved memories' '• /claude-mem help - Show this help' '' '**Quick Shortcuts:**' '• /save - Direct save' '• /remember - Direct search' '' '**About /save:**' 'Quick way to save an overview to claude-mem without processing the' 'entire transcript. Use this when you dont need a detailed archive,' 'just a summary of key points and decisions.' '' '**Optional Features (configure during install):**' '• Compress on /clear: Archives full transcript when clearing (off by default)' '• Session start: Loads recent memories when starting Claude Code' '' 'For more details: claude-mem --help' && exit 0`
+
+### Process other commands
+Handle claude-mem operation: $ARGUMENTS
+
+If $ARGUMENTS starts with "save":
+- Write an overview of the current conversation context
+- Add it to claude-mem using the chroma MCP tools  
+- Save the overview using: `claude-mem save "your overview message"`
+
+If $ARGUMENTS starts with "remember":
+- Search claude-mem for relevant memories using the query
+- Display the most relevant memories from previous sessions
+- Use chroma_query_documents to find and present context

hooks/pre-compact.js

@@ -17,10 +17,12 @@ import {
   debugLog 
 } from './shared/hook-helpers.js';
 
-// Set up stdin immediately before any async operations
+
+// Set up stdin immediately
 process.stdin.setEncoding('utf8');
 process.stdin.resume(); // Explicitly enter flowing mode to prevent data loss
 
+
 // Read input from stdin
 let input = '';
 process.stdin.on('data', chunk => {
@@ -28,6 +30,7 @@ process.stdin.on('data', chunk => {
 });
 
 process.stdin.on('end', async () => {
+  
   try {
     // Load CLI command inside try-catch to handle config errors properly
     const cliCommand = loadCliCommand();

hooks/shared/path-resolver.js

@@ -40,6 +40,14 @@ export function getLogsDir() {
   return process.env.CLAUDE_MEM_LOGS_DIR || join(getDataDir(), 'logs');
 }
 
+/**
+ * Gets the compact flag file path
+ * @returns {string} Compact flag file path
+ */
+export function getCompactFlagPath() {
+  return join(getDataDir(), '.compact-running');
+}
+
 /**
  * Gets all common paths used by hooks
  * @returns {Object} Object containing all common paths
@@ -49,6 +57,7 @@ export function getPaths() {
     dataDir: getDataDir(),
     settingsPath: getSettingsPath(),
     archivesDir: getArchivesDir(),
-    logsDir: getLogsDir()
+    logsDir: getLogsDir(),
+    compactFlagPath: getCompactFlagPath()
   };
 }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem",
-  "version": "3.5.4",
+  "version": "3.6.2",
   "description": "Memory compression system for Claude Code - persist context across sessions",
   "keywords": [
     "claude",
@@ -52,6 +52,7 @@
     "dist",
     "hooks",
     "commands",
-    ".mcp.json"
+    ".mcp.json",
+    "CHANGELOG.md"
   ]
 }