claude-mem 3.3.10 → 3.3.12

package/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

package/claude-mem

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Detect platform and architecture
+const platform = process.platform;
+const arch = process.arch;
+
+// Map platform/arch to binary filename
+let binaryName;
+
+if (platform === 'win32') {
+  binaryName = 'claude-mem.exe';
+} else if (platform === 'linux') {
+  if (arch === 'arm64' || arch === 'aarch64') {
+    binaryName = 'claude-mem-linux-arm64';
+  } else {
+    binaryName = 'claude-mem-linux';
+  }
+} else if (platform === 'darwin') {
+  if (arch === 'arm64') {
+    binaryName = 'claude-mem-macos-arm64';
+  } else {
+    binaryName = 'claude-mem-macos-x64';
+  }
+} else {
+  console.error(`❌ Unsupported platform: ${platform}-${arch}`);
+  console.error('Supported platforms:');
+  console.error('  - Windows x64');
+  console.error('  - Linux x64');
+  console.error('  - Linux ARM64');
+  console.error('  - macOS x64');
+  console.error('  - macOS ARM64');
+  process.exit(1);
+}
+
+// Find the binary path
+const binDir = path.join(__dirname, 'bin');
+const binaryPath = path.join(binDir, binaryName);
+
+// Check if binary exists
+if (!fs.existsSync(binaryPath)) {
+  console.error(`❌ Binary not found: ${binaryPath}`);
+  console.error(`Expected binary: ${binaryName}`);
+  console.error(`Platform: ${platform}-${arch}`);
+  process.exit(1);
+}
+
+// Execute the binary with all arguments
+try {
+  const args = process.argv.slice(2);
+  execSync(`"${binaryPath}" ${args.join(' ')}`, {
+    stdio: 'inherit',
+    cwd: process.cwd()
+  });
+} catch (error) {
+  process.exit(error.status || 1);
+}

package/hooks/pre-compact.js

@@ -18,6 +18,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 => {

package/hooks/session-end.js

@@ -26,6 +26,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 => {

package/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 => {

package/package.json

@@ -1,25 +1,7 @@
 {
   "name": "claude-mem",
-  "version": "3.3.10",
+  "version": "3.3.12",
   "description": "Memory compression system for Claude Code - persist context across sessions",
-  "type": "module",
-  "main": "claude-mem",
-  "scripts": {
-    "dev": "tsx src/bin/cli.ts",
-    "dev:install": "node dist/cli.js install --force",
-    "dev:status": "node dist/cli.js status",
-    "dev:compress": "node dist/cli.js compress",
-    "dev:load": "node dist/cli.js load-context",
-    "dev:uninstall": "node dist/cli.js uninstall",
-    "build": "tsc",
-    "test:watch": "npm test -- --watch",
-    "lint": "eslint 'src/**/*.ts' 'hooks/**/*.ts' 'test/**/*.ts'",
-    "lint:fix": "npm run lint -- --fix",
-    "format": "prettier --write 'src/**/*.ts' 'hooks/**/*.ts' 'test/**/*.ts'",
-    "build:multiplatform": "./scripts/build-multiplatform.sh",
-    "publish": "./scripts/npm-publish.sh && cd releases/npm-package && npm publish",
-    "publish:latest": "npm version patch && ./scripts/npm-publish.sh && cd releases/npm-package && npm publish"
-  },
   "keywords": [
     "claude",
     "claude-code",
@@ -28,9 +10,7 @@
     "compression",
     "knowledge-graph",
     "transcript",
-    "cli",
-    "typescript",
-    "bun"
+    "cli"
   ],
   "author": "Alex Newman",
   "license": "SEE LICENSE IN LICENSE",
@@ -46,43 +26,14 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "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",
-    "commander": "^14.0.0",
-    "figlet": "^1.8.2",
-    "glob": "^11.0.3",
-    "gradient-string": "^3.0.0",
-    "handlebars": "^4.7.8",
-    "oh-my-logo": "^0.3.2"
-  },
-  "devDependencies": {
-    "@types/chai": "^4.3.0",
-    "@types/figlet": "^1.7.0",
-    "@types/handlebars": "^4.0.40",
-    "@types/node": "^20.0.0",
-    "@typescript-eslint/eslint-plugin": "^6.0.0",
-    "@typescript-eslint/parser": "^6.0.0",
-    "chai": "^4.3.0",
-    "eslint": "^8.0.0",
-    "prettier": "^3.0.0",
-    "ts-node": "^10.0.0",
-    "tsx": "^4.20.5",
-    "typescript": "^5.0.0"
-  },
-  "engines": {
-    "node": ">=18.0.0",
-    "bun": ">=1.0.0"
-  },
   "bin": {
-    "claude-mem": "dist/bin/cli.js"
+    "claude-mem": "./claude-mem"
   },
   "files": [
-    "dist",
+    "claude-mem",
+    "bin/**",
     "hooks",
-    "docs"
+    "dist",
+    ".mcp.json"
   ]
 }

package/dist/bin/cli.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/bin/cli.js

@@ -1,179 +0,0 @@
-#!/usr/bin/env node
-// <Block> 1.1 ====================================
-// CLI Dependencies and Imports Setup
-// Natural pattern: Import what you need before using it
-import { Command } from 'commander';
-import { PACKAGE_NAME, PACKAGE_VERSION, PACKAGE_DESCRIPTION } from '../shared/config.js';
-// Import command handlers
-import { compress } from '../commands/compress.js';
-import { install } from '../commands/install.js';
-import { uninstall } from '../commands/uninstall.js';
-import { status } from '../commands/status.js';
-import { logs } from '../commands/logs.js';
-import { loadContext } from '../commands/load-context.js';
-import { trash } from '../commands/trash.js';
-import { restore } from '../commands/restore.js';
-const program = new Command();
-// </Block> =======================================
-// <Block> 1.2 ====================================
-// Program Configuration
-// Natural pattern: Configure program metadata first
-program
-    .name(PACKAGE_NAME)
-    .description(PACKAGE_DESCRIPTION)
-    .version(PACKAGE_VERSION);
-// </Block> =======================================
-// <Block> 1.3 ====================================
-// Compress Command Definition
-// Natural pattern: Define command with its options and handler
-// Compress command
-program
-    .command('compress [transcript]')
-    .description('Compress a Claude Code transcript into memory')
-    .option('--output <path>', 'Output directory for compressed files')
-    .option('--dry-run', 'Show what would be compressed without doing it')
-    .option('-v, --verbose', 'Show detailed output')
-    .action(compress);
-// </Block> =======================================
-// <Block> 1.4 ====================================
-// Install Command Definition
-// Natural pattern: Define command with its options and handler
-// Install command
-program
-    .command('install')
-    .description('Install Claude Code hooks for automatic compression')
-    .option('--user', 'Install for current user (default)')
-    .option('--project', 'Install for current project only')
-    .option('--local', 'Install to custom local directory')
-    .option('--path <path>', 'Custom installation path (with --local)')
-    .option('--timeout <ms>', 'Hook execution timeout in milliseconds', '180000')
-    .option('--skip-mcp', 'Skip Chroma MCP server installation')
-    .option('--force', 'Force installation even if already installed')
-    .action(install);
-// </Block> =======================================
-// <Block> 1.5 ====================================
-// Uninstall Command Definition
-// Natural pattern: Define command with its options and handler
-// Uninstall command
-program
-    .command('uninstall')
-    .description('Remove Claude Code hooks')
-    .option('--user', 'Remove from user settings (default)')
-    .option('--project', 'Remove from project settings')
-    .option('--all', 'Remove from both user and project settings')
-    .action(uninstall);
-// </Block> =======================================
-// <Block> 1.6 ====================================
-// Status Command Definition
-// Natural pattern: Define command with its handler
-// Status command
-program
-    .command('status')
-    .description('Check installation status of Claude Memory System')
-    .action(status);
-// </Block> =======================================
-// <Block> 1.7 ====================================
-// Logs Command Definition
-// Natural pattern: Define command with its options and handler
-// Logs command
-program
-    .command('logs')
-    .description('View claude-mem operation logs')
-    .option('--debug', 'Show debug logs only')
-    .option('--error', 'Show error logs only')
-    .option('--tail [n]', 'Show last n lines', '50')
-    .option('--follow', 'Follow log output')
-    .action(logs);
-// </Block> =======================================
-// <Block> 1.8 ====================================
-// Load-Context Command Definition
-// Natural pattern: Define command with its options and handler
-// Load-context command
-program
-    .command('load-context')
-    .description('Load compressed memories for current session')
-    .option('--project <name>', 'Filter by project name')
-    .option('--count <n>', 'Number of memories to load', '10')
-    .option('--raw', 'Output raw JSON instead of formatted text')
-    .option('--format <type>', 'Output format: json, session-start, or default')
-    .action(loadContext);
-// </Block> =======================================
-// <Block> 1.9 ====================================
-// Trash and Restore Commands Definition
-// Natural pattern: Define commands for safe file operations
-// Trash command with subcommands
-const trashCmd = program
-    .command('trash')
-    .description('Manage trash bin for safe file deletion')
-    .argument('[files...]', 'Files to move to trash')
-    .option('-r, --recursive', 'Remove directories recursively')
-    .option('-R', 'Remove directories recursively (same as -r)')
-    .option('-f, --force', 'Suppress errors for nonexistent files')
-    .action(async (files, options) => {
-    // If no files provided, show help
-    if (!files || files.length === 0) {
-        trashCmd.outputHelp();
-        return;
-    }
-    // Map -R to recursive
-    if (options.R)
-        options.recursive = true;
-    await trash(files, {
-        force: options.force,
-        recursive: options.recursive
-    });
-});
-// Trash view subcommand
-trashCmd
-    .command('view')
-    .description('View contents of trash bin')
-    .action(async () => {
-    const { viewTrash } = await import('../commands/trash-view.js');
-    await viewTrash();
-});
-// Trash empty subcommand
-trashCmd
-    .command('empty')
-    .description('Permanently delete all files in trash')
-    .option('-f, --force', 'Skip confirmation prompt')
-    .action(async (options) => {
-    const { emptyTrash } = await import('../commands/trash-empty.js');
-    await emptyTrash(options);
-});
-// Restore command
-program
-    .command('restore')
-    .description('Restore files from trash interactively')
-    .action(restore);
-// </Block> =======================================
-// <Block> 1.10 ===================================  
-// Hook Commands for Binary Distribution
-// Internal commands called by hook wrappers
-program
-    .command('hook:pre-compact', { hidden: true })
-    .description('Internal pre-compact hook handler')
-    .action(async () => {
-    const { preCompactHook } = await import('../commands/hooks.js');
-    await preCompactHook();
-});
-program
-    .command('hook:session-start', { hidden: true })
-    .description('Internal session-start hook handler')
-    .action(async () => {
-    const { sessionStartHook } = await import('../commands/hooks.js');
-    await sessionStartHook();
-});
-program
-    .command('hook:session-end', { hidden: true })
-    .description('Internal session-end hook handler')
-    .action(async () => {
-    const { sessionEndHook } = await import('../commands/hooks.js');
-    await sessionEndHook();
-});
-// </Block> =======================================
-// <Block> 1.11 ===================================
-// CLI Execution
-// Natural pattern: After defining all commands, parse and execute
-// Parse arguments and execute
-program.parse();
-// </Block> =======================================

package/dist/commands/compress.d.ts

@@ -1,2 +0,0 @@
-import { OptionValues } from 'commander';
-export declare function compress(transcript?: string, options?: OptionValues): Promise<void>;

package/dist/commands/compress.js

@@ -1,27 +0,0 @@
-import { basename } from 'path';
-import { createLoadingMessage, createCompletionMessage, createOperationSummary, createUserFriendlyError } from '../prompts/templates/context/ContextTemplates.js';
-export async function compress(transcript, options = {}) {
-    console.log(createLoadingMessage('compressing'));
-    if (!transcript) {
-        console.log(createUserFriendlyError('Compression', 'No transcript file provided', 'Please provide a path to a transcript file'));
-        return;
-    }
-    try {
-        const startTime = Date.now();
-        // Import and run compression
-        const { TranscriptCompressor } = await import('../core/compression/TranscriptCompressor.js');
-        const compressor = new TranscriptCompressor({
-            verbose: options.verbose || false
-        });
-        const sessionId = options.sessionId || basename(transcript, '.jsonl');
-        const archivePath = await compressor.compress(transcript, sessionId);
-        const duration = Date.now() - startTime;
-        console.log(createCompletionMessage('Compression', undefined, `Session archived as ${basename(archivePath)}`));
-        console.log(createOperationSummary('compress', { count: 1, duration, details: `Session: ${sessionId}` }));
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        console.log(createUserFriendlyError('Compression', errorMessage, 'Check that the transcript file exists and you have write permissions'));
-        throw error; // Re-throw to maintain existing error handling behavior
-    }
-}

package/dist/commands/hooks.d.ts

@@ -1,19 +0,0 @@
-/**
- * Hook command handlers for binary distribution
- * These execute the actual hook logic embedded in the binary
- */
-/**
- * Pre-compact hook handler
- * Runs compression on the Claude Code transcript
- */
-export declare function preCompactHook(): Promise<void>;
-/**
- * Session-start hook handler
- * Loads context for the new session
- */
-export declare function sessionStartHook(): Promise<void>;
-/**
- * Session-end hook handler
- * Compresses session transcript when ending with /clear
- */
-export declare function sessionEndHook(): Promise<void>;

package/dist/commands/hooks.js

@@ -1,131 +0,0 @@
-/**
- * Hook command handlers for binary distribution
- * These execute the actual hook logic embedded in the binary
- */
-import { compress } from './compress.js';
-import { loadContext } from './load-context.js';
-/**
- * Pre-compact hook handler
- * Runs compression on the Claude Code transcript
- */
-export async function preCompactHook() {
-    try {
-        // Read hook data from stdin (Claude Code sends JSON)
-        let inputData = '';
-        // Set up stdin to read data
-        process.stdin.setEncoding('utf8');
-        // Collect all input data
-        for await (const chunk of process.stdin) {
-            inputData += chunk;
-        }
-        // Parse the JSON input
-        let transcriptPath;
-        if (inputData) {
-            try {
-                const hookData = JSON.parse(inputData);
-                transcriptPath = hookData.transcript_path;
-            }
-            catch (parseError) {
-                // If JSON parsing fails, treat the input as a direct path
-                transcriptPath = inputData.trim();
-            }
-        }
-        // Fallback to environment variable or command line argument
-        if (!transcriptPath) {
-            transcriptPath = process.env.TRANSCRIPT_PATH || process.argv[2];
-        }
-        if (!transcriptPath) {
-            console.log('🗜️ Compressing session transcript...');
-            console.log('❌ No transcript path provided to pre-compact hook');
-            console.log('Hook data received:', inputData || 'none');
-            console.log('Environment TRANSCRIPT_PATH:', process.env.TRANSCRIPT_PATH || 'not set');
-            console.log('Command line args:', process.argv.slice(2));
-            return;
-        }
-        // Run compression with the transcript path
-        await compress(transcriptPath, { dryRun: false });
-    }
-    catch (error) {
-        console.error('Pre-compact hook failed:', error.message);
-        process.exit(1);
-    }
-}
-/**
- * Session-start hook handler
- * Loads context for the new session
- */
-export async function sessionStartHook() {
-    try {
-        // Read hook data from stdin (Claude Code sends JSON)
-        let inputData = '';
-        // Set up stdin to read data
-        process.stdin.setEncoding('utf8');
-        // Collect all input data
-        for await (const chunk of process.stdin) {
-            inputData += chunk;
-        }
-        // Parse the JSON input to get the current working directory
-        let project;
-        if (inputData) {
-            try {
-                const hookData = JSON.parse(inputData);
-                // Extract project name from cwd if provided
-                if (hookData.cwd) {
-                    const pathParts = hookData.cwd.split('/');
-                    project = pathParts[pathParts.length - 1];
-                }
-            }
-            catch (parseError) {
-                // If JSON parsing fails, continue without project filtering
-                console.error('Failed to parse session-start hook data:', parseError);
-            }
-        }
-        // If no project from hook data, try to get from current working directory
-        if (!project) {
-            const pathParts = process.cwd().split('/');
-            project = pathParts[pathParts.length - 1];
-        }
-        // Load context with session-start format and project filtering
-        await loadContext({ format: 'session-start', count: '10', project });
-    }
-    catch (error) {
-        console.error('Session-start hook failed:', error.message);
-        process.exit(1);
-    }
-}
-/**
- * Session-end hook handler
- * Compresses session transcript when ending with /clear
- */
-export async function sessionEndHook() {
-    try {
-        // Read hook data from stdin (Claude Code sends JSON)
-        let inputData = '';
-        // Set up stdin to read data
-        process.stdin.setEncoding('utf8');
-        // Collect all input data
-        for await (const chunk of process.stdin) {
-            inputData += chunk;
-        }
-        // Parse the JSON input to check the reason for session end
-        if (inputData) {
-            try {
-                const hookData = JSON.parse(inputData);
-                // If reason is "clear", compress the session transcript before it's deleted
-                if (hookData.reason === 'clear' && hookData.transcript_path) {
-                    console.log('🗜️ Compressing current session before /clear...');
-                    await compress(hookData.transcript_path, { dryRun: false });
-                }
-            }
-            catch (parseError) {
-                // If JSON parsing fails, log but don't fail the hook
-                console.error('Failed to parse hook data:', parseError);
-            }
-        }
-        console.log('Session ended successfully');
-    }
-    catch (error) {
-        console.error('Session-end hook failed:', error.message);
-        process.exit(1);
-    }
-}

package/dist/commands/install.d.ts

@@ -1,2 +0,0 @@
-import { OptionValues } from 'commander';
-export declare function install(options?: OptionValues): Promise<void>;