Release v3.5.4

- Updated to match npm package structure
- Includes minified dist/claude-mem.min.js
- Added commands directory
- Updated hooks with latest fixes
- Synced with npm package claude-mem@3.5.4

.gitignore

@@ -1,13 +0,0 @@
-# Binaries (distributed via GitHub releases)
-*.exe
-*.app
-claude-mem
-claude-mem-*
-
-# Temporary files
-*.tmp
-*.log
-.DS_Store
-
-# Node modules (if any)
-node_modules/

INSTALL.md

@@ -1,58 +0,0 @@
-# Installation Guide
-
-## Quick Install (Recommended)
-
-### Via NPM
-```bash
-npm install -g claude-mem
-```
-
-### Via curl
-```bash
-curl -fsSL https://raw.githubusercontent.com/thedotmack/claude-mem/main/install.sh | bash
-```
-
-## Manual Installation
-
-1. Download the appropriate binary for your platform from [Releases](https://github.com/thedotmack/claude-mem/releases/latest):
-   - **Windows**: `claude-mem.exe`
-   - **Linux x64**: `claude-mem-linux`
-   - **Linux ARM64**: `claude-mem-linux-arm64`
-   - **macOS Intel**: `claude-mem-macos-x64`
-   - **macOS Apple Silicon**: `claude-mem-macos-arm64`
-
-2. Make it executable (Unix-based systems):
-   ```bash
-   chmod +x claude-mem-*
-   ```
-
-3. Move to your PATH:
-   ```bash
-   sudo mv claude-mem-* /usr/local/bin/claude-mem
-   ```
-
-## After Installation
-
-Once the binary is installed, set up Claude Code integration:
-
-```bash
-claude-mem install
-```
-
-This will:
-- Install the Chroma MCP server
-- Configure Claude Code hooks
-- Set up the memory system
-
-## Platform Detection
-
-The `claude-mem` command automatically detects your platform and runs the correct binary. No manual selection needed!
-
-## Troubleshooting
-
-If you get a "command not found" error:
-1. Ensure the binary is in your PATH
-2. Try running with full path: `./claude-mem`
-3. Check binary permissions: `ls -la claude-mem*`
-
-For other issues, please check our [Issues](https://github.com/thedotmack/claude-mem/issues) page.

LICENSE

@@ -1,43 +1,31 @@
-# Claude Mem License
+CLAUDE-MEM SOFTWARE LICENSE
 
-Copyright (c) 2024 Alex Newman (@thedotmack)
+Copyright (c) 2024 Alex Newman (@thedotmack). All rights reserved.
-
-## Binary Distribution License
-
-The compiled binaries (claude-mem, claude-mem.exe, etc.) are provided free of charge for personal and commercial use under the following terms:
-
-1. **USE**: You may use the binaries for any purpose.
-2. **DISTRIBUTION**: You may redistribute the unmodified binaries.
-3. **NO REVERSE ENGINEERING**: You may not decompile, disassemble, or reverse engineer the binaries.
-4. **NO MODIFICATION**: You may not modify the binary files.
-5. **NO WARRANTY**: The software is provided "as is" without warranty of any kind.
-
-## Hook Files License (MIT)
-
-The hook files in the `/hooks` directory are licensed under the MIT License:
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
-of these hook files and associated documentation files (the "Software"), to deal
+of this software in its compiled/distributed form via npm, to use the software
-in the Software without restriction, including without limitation the rights
+for any purpose, subject to the following conditions:
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in all
+1. USE RIGHTS: You may use the claude-mem CLI tool for personal or commercial
-copies or substantial portions of the Software.
+   purposes without restriction.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+2. NO SOURCE CODE RIGHTS: This license does NOT grant access to source code,
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+   modification rights, or redistribution rights. The software is provided
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+   as-is in its compiled form only.
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
 
-## Contributions
+3. NO REVERSE ENGINEERING: You may not reverse engineer, decompile, or
+   disassemble the software.
 
-By submitting pull requests for hook files or documentation, you agree to license your contributions under the MIT License.
+4. NO REDISTRIBUTION: You may not redistribute, repackage, or resell this
+   software. Users must install it from the official npm registry.
 
-## Trademark
+5. NO WARRANTY: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 
-"Claude Mem" is a trademark of Alex Newman. You may use the name when referring to this software, but not in a way that implies endorsement or affiliation.
+6. LIMITATION OF LIABILITY: IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
+   CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
+   OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
+   THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+For questions about this license, contact: thedotmack@gmail.com

README.md

@@ -50,12 +50,17 @@ Transform your Claude Code experience from forgetful to persistent, from isolate
 
 ## 🛠 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
+# Set up Claude Code integration (installs uv if needed)
 claude-mem install
 
 # Restart Claude Code to activate
@@ -67,6 +72,8 @@ claude-mem install
 npx claude-mem install
 ```
 
+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.
+
 ### Verification
 ```bash
 # Check installation status

RELEASE.md

@@ -1,40 +0,0 @@
-# Claude Mem v3.3.8
-
-## 🚀 Installation
-
-### Quick Install (Recommended)
-```bash
-curl -fsSL https://raw.githubusercontent.com/thedotmack/claude-mem/main/install.sh | bash
-```
-
-### Manual Download
-Download the appropriate binary for your platform from the [releases page](https://github.com/thedotmack/claude-mem/releases/latest):
-
-- **Windows x64**: `claude-mem.exe`
-- **Linux x64**: `claude-mem-linux`
-- **Linux ARM64**: `claude-mem-linux-arm64`
-- **macOS ARM64** (Apple Silicon): `claude-mem-macos-arm64`
-- **macOS x64** (Intel): `claude-mem-macos-x64`
-
-## 📦 What's Included
-
-- Multi-platform binaries for Windows, Linux, and macOS
-- Hook system for customization
-- Full documentation
-- MCP server integration for Claude Code
-
-## 🔧 Supported Platforms
-
-| Platform | Architecture | Binary Name |
-|----------|--------------|-------------|
-| Windows | x64 | claude-mem.exe |
-| Linux | x64 | claude-mem-linux |
-| Linux | ARM64 | claude-mem-linux-arm64 |
-| macOS | ARM64 (Apple Silicon) | claude-mem-macos-arm64 |
-| macOS | x64 (Intel) | claude-mem-macos-x64 |
-
-## 📝 License
-
-Binary distribution under proprietary license (free to use).
-Hook files under MIT license (open source).
-See LICENSE file for details.

commands/remember.md

@@ -0,0 +1 @@
+Search claude-mem for #$ARGUMENTS and look up relevant context to help clarify what we are working on.

commands/save.md

@@ -0,0 +1,3 @@
+Write an overview of the current conversation context and:
+1. Add it to claude-mem using the chroma MCP tools
+2. Save the overview using the claude-mem CLI tool: `claude-mem save "your overview message"`

hooks/pre-compact.js

@@ -9,6 +9,7 @@
  */
 
 import { loadCliCommand } from './shared/config-loader.js';
+import { getLogsDir } from './shared/path-resolver.js';
 import { 
   createHookResponse, 
   executeCliCommand, 
@@ -16,7 +17,9 @@ import {
   debugLog 
 } from './shared/hook-helpers.js';
 
-const cliCommand = loadCliCommand();
+// Set up stdin immediately before any async operations
+process.stdin.setEncoding('utf8');
+process.stdin.resume(); // Explicitly enter flowing mode to prevent data loss
 
 // Read input from stdin
 let input = '';
@@ -26,6 +29,9 @@ 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();
+    
     const payload = JSON.parse(input);
     debugLog('Pre-compact hook started', { payload });
 
@@ -33,17 +39,18 @@ process.stdin.on('end', async () => {
     const validation = validateHookPayload(payload, 'PreCompact');
     if (!validation.valid) {
       const response = createHookResponse('PreCompact', false, { reason: validation.error });
-      console.log(JSON.stringify(response));
+      debugLog('Validation failed', { response });
+      // Exit silently - validation failure is expected flow control
       process.exit(0);
     }
 
     // Check for environment-based blocking conditions
     if (payload.trigger === 'auto' && process.env.DISABLE_AUTO_COMPRESSION === 'true') {
-      debugLog('Auto-compression disabled by configuration');
       const response = createHookResponse('PreCompact', false, { 
         reason: 'Auto-compression disabled by configuration' 
       });
-      console.log(JSON.stringify(response));
+      debugLog('Auto-compression disabled', { response });
+      // Exit silently - disabled compression is expected flow control
       process.exit(0);
     }
 
@@ -56,26 +63,24 @@ process.stdin.on('end', async () => {
     const result = await executeCliCommand(cliCommand, ['compress', payload.transcript_path]);
     
     if (!result.success) {
-      debugLog('Compression command failed', { stderr: result.stderr });
       const response = createHookResponse('PreCompact', false, { 
         reason: `Compression failed: ${result.stderr || 'Unknown error'}` 
       });
-      console.log(JSON.stringify(response));
+      debugLog('Compression command failed', { stderr: result.stderr, response });
-      process.exit(0);
+      console.log(`claude-mem error: compression failed, see logs at ${getLogsDir()}`);
+      process.exit(1);  // Exit with error code for actual compression failure
     }
 
-    // Success - create standardized approval response using HookTemplates
+    // Success - exit silently (suppressOutput is true)
     debugLog('Compression completed successfully');
-    const response = createHookResponse('PreCompact', true);
-    console.log(JSON.stringify(response));
     process.exit(0);
 
   } catch (error) {
-    debugLog('Pre-compact hook error', { error: error.message });
     const response = createHookResponse('PreCompact', false, { 
       reason: `Hook execution error: ${error.message}` 
     });
-    console.log(JSON.stringify(response));
+    debugLog('Pre-compact hook error', { error: error.message, response });
+    console.log(`claude-mem error: hook failed, see logs at ${getLogsDir()}`);
     process.exit(1);
   }
 });

hooks/session-end.js

@@ -5,16 +5,15 @@
  */
 
 import { loadCliCommand } from './shared/config-loader.js';
+import { getSettingsPath, getArchivesDir } from './shared/path-resolver.js';
 import { execSync } from 'child_process';
-import { join } from 'path';
-import { homedir } from 'os';
 import { existsSync, readFileSync } from 'fs';
 
 const cliCommand = loadCliCommand();
 
 // Check if save-on-clear is enabled
 function isSaveOnClearEnabled() {
-  const settingsPath = join(homedir(), '.claude-mem', 'settings.json');
+  const settingsPath = getSettingsPath();
   if (existsSync(settingsPath)) {
     try {
       const settings = JSON.parse(readFileSync(settingsPath, 'utf8'));
@@ -26,6 +25,10 @@ function isSaveOnClearEnabled() {
   return false;
 }
 
+// Set up stdin immediately before any async operations
+process.stdin.setEncoding('utf8');
+process.stdin.resume(); // Explicitly enter flowing mode to prevent data loss
+
 // Read input
 let input = '';
 process.stdin.on('data', chunk => {
@@ -41,7 +44,7 @@ process.stdin.on('end', async () => {
     
     try {
       // Use the CLI to compress current transcript
-      execSync(`${cliCommand} compress --output ${homedir()}/.claude-mem/archives`, {
+      execSync(`${cliCommand} compress --output ${getArchivesDir()}`, {
         stdio: 'inherit',
         env: { ...process.env, CLAUDE_MEM_SILENT: 'true' }
       });

hooks/session-start.js

@@ -21,6 +21,10 @@ import {
 
 const cliCommand = loadCliCommand();
 
+// Set up stdin immediately before any async operations
+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 => {
@@ -47,14 +51,14 @@ process.stdin.on('end', async () => {
     // Skip load-context when source is "resume" to avoid duplicate context
     if (payload.source === 'resume') {
       debugLog('Skipping load-context for resume source');
-      // Output nothing at all for resume - no message, no context
+      // Output valid JSON response with suppressOutput for resume
+      const response = createHookResponse('SessionStart', true);
+      console.log(JSON.stringify(response));
       process.exit(0);
     }
 
-    // Extract project name from current working directory and sanitize
+    // Extract project name from current working directory
-    const rawProjectName = path.basename(process.cwd());
+    const projectName = path.basename(process.cwd());
-    const projectName = rawProjectName.replace(/-/g, '_');
-    debugLog('Extracted project name', { rawProjectName, projectName });
 
     // Load context using standardized CLI execution helper
     const contextResult = await executeCliCommand(cliCommand, [
@@ -152,7 +156,7 @@ function extractProjectName(transcriptPath) {
   
   // Look for project pattern: /path/to/PROJECT_NAME/.claude/
   // Need to get PROJECT_NAME, not the parent directory
-  const parts = transcriptPath.split('/');
+  const parts = transcriptPath.split(path.sep);
   const claudeIndex = parts.indexOf('.claude');
   
   if (claudeIndex > 0) {

hooks/shared/hook-helpers.js

@@ -47,13 +47,10 @@ export function createHookResponse(hookType, success, options = {}) {
         }
       };
     } else if (success) {
+      // No context - just suppress output without any message
       return {
         continue: true,
-        suppressOutput: true,
+        suppressOutput: true
-        hookSpecificOutput: {
-          hookEventName: 'SessionStart',
-          additionalContext: 'Starting fresh session - no previous context available'
-        }
       };
     } else {
       return {

hooks/shared/path-resolver.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+
+/**
+ * Path resolver utility for Claude Memory hooks
+ * Provides proper path handling using environment variables
+ */
+
+import { join } from 'path';
+import { homedir } from 'os';
+
+/**
+ * Gets the base data directory for claude-mem
+ * @returns {string} Data directory path
+ */
+export function getDataDir() {
+  return process.env.CLAUDE_MEM_DATA_DIR || join(homedir(), '.claude-mem');
+}
+
+/**
+ * Gets the settings file path
+ * @returns {string} Settings file path
+ */
+export function getSettingsPath() {
+  return join(getDataDir(), 'settings.json');
+}
+
+/**
+ * Gets the archives directory path
+ * @returns {string} Archives directory path
+ */
+export function getArchivesDir() {
+  return process.env.CLAUDE_MEM_ARCHIVES_DIR || join(getDataDir(), 'archives');
+}
+
+/**
+ * Gets the logs directory path
+ * @returns {string} Logs directory path
+ */
+export function getLogsDir() {
+  return process.env.CLAUDE_MEM_LOGS_DIR || join(getDataDir(), 'logs');
+}
+
+/**
+ * Gets all common paths used by hooks
+ * @returns {Object} Object containing all common paths
+ */
+export function getPaths() {
+  return {
+    dataDir: getDataDir(),
+    settingsPath: getSettingsPath(),
+    archivesDir: getArchivesDir(),
+    logsDir: getLogsDir()
+  };
+}

install.sh

@@ -1,58 +0,0 @@
-#!/bin/bash
-# Claude Mem Installation Script
-
-set -e
-
-VERSION="${1:-latest}"
-PLATFORM=""
-ARCH=$(uname -m)
-OS=$(uname -s)
-
-# Detect platform
-case "$OS" in
-  Darwin)
-    if [ "$ARCH" = "arm64" ]; then
-      PLATFORM="macos-arm64"
-      BINARY="claude-mem-macos-arm64"
-    else
-      PLATFORM="macos-x64"
-      BINARY="claude-mem-macos-x64"
-    fi
-    ;;
-  Linux)
-    if [ "$ARCH" = "aarch64" ]; then
-      PLATFORM="linux-arm64"
-      BINARY="claude-mem-linux-arm64"
-    else
-      PLATFORM="linux-x64"
-      BINARY="claude-mem-linux"
-    fi
-    ;;
-  MINGW*|MSYS*|CYGWIN*)
-    PLATFORM="windows-x64"
-    BINARY="claude-mem.exe"
-    ;;
-  *)
-    echo "Unsupported platform: $OS $ARCH"
-    exit 1
-    ;;
-esac
-
-echo "📥 Downloading Claude Mem for $PLATFORM..."
-
-# Download binary from GitHub releases
-if [ "$VERSION" = "latest" ]; then
-  DOWNLOAD_URL="https://github.com/thedotmack/claude-mem/releases/latest/download/${BINARY}"
-else
-  DOWNLOAD_URL="https://github.com/thedotmack/claude-mem/releases/download/${VERSION}/${BINARY}"
-fi
-
-curl -L -o claude-mem "$DOWNLOAD_URL"
-
-# Make executable (non-Windows)
-if [ "$OS" != "MINGW" ] && [ "$OS" != "MSYS" ] && [ "$OS" != "CYGWIN" ]; then
-  chmod +x claude-mem
-fi
-
-echo "✅ Claude Mem installed successfully!"
-echo "Run ./claude-mem --help to get started"

package.json

@@ -0,0 +1,57 @@
+{
+  "name": "claude-mem",
+  "version": "3.5.4",
+  "description": "Memory compression system for Claude Code - persist context across sessions",
+  "keywords": [
+    "claude",
+    "claude-code",
+    "mcp",
+    "memory",
+    "compression",
+    "knowledge-graph",
+    "transcript",
+    "cli",
+    "typescript",
+    "bun"
+  ],
+  "author": "Alex Newman",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thedotmack/claude-mem.git"
+  },
+  "homepage": "https://github.com/thedotmack/claude-mem#readme",
+  "bugs": {
+    "url": "https://github.com/thedotmack/claude-mem/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bin": {
+    "claude-mem": "./dist/claude-mem.min.js"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-code": "^1.0.88",
+    "@clack/prompts": "^0.11.0",
+    "@modelcontextprotocol/sdk": "^0.5.0",
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.0",
+    "chromadb": "^3.0.14",
+    "commander": "^14.0.0",
+    "glob": "^11.0.3",
+    "gradient-string": "^3.0.0",
+    "handlebars": "^4.7.8",
+    "oh-my-logo": "^0.3.2"
+  },
+  "files": [
+    "dist",
+    "hooks",
+    "commands",
+    ".mcp.json"
+  ]
+}