mnemex 1.0.0

package/README.md

@@ -0,0 +1,75 @@
+# mnemex
+
+**Memory Extension for AI Agents** - Intelligent context optimization via semantic retrieval.
+
+An MCP server that dramatically reduces Claude Code's context window usage by returning relevant code chunks instead of whole files.
+
+## Features
+
+- **90%+ Context Reduction** - Returns only relevant code chunks, not entire files
+- **Semantic Search** - Understands code meaning, not just keywords
+- **Auto-indexing** - Indexes your codebase automatically on first search
+- **Real Embeddings** - Uses all-MiniLM-L6-v2 model for high-quality vectors
+- **MMR Diversity** - Maximal Marginal Relevance ensures diverse results
+- **Zero Config** - Works out of the box with Claude Code
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g mnemex
+
+# Configure Claude Code integration
+mnemex install
+
+# That's it! Claude will now use mnemex_search automatically
+```
+
+## How It Works
+
+1. **Auto-indexes** your codebase on first search (or use `mnemex index ./src -r`)
+2. **Embeds** code chunks using a local ML model
+3. **Searches** semantically when Claude asks about your code
+4. **Returns** only the relevant chunks (~10) instead of whole files
+
+### Example
+
+When Claude Code asks "how does authentication work?", instead of returning 5 full files (8,000+ tokens), mnemex returns just the relevant functions (~500 tokens).
+
+## Commands
+
+```bash
+mnemex install     # Add to Claude Code MCP config
+mnemex uninstall   # Remove from Claude Code
+mnemex index <path> -r  # Manually index a directory
+mnemex stats       # Show indexing statistics
+mnemex doctor      # Run diagnostics
+```
+
+## MCP Tools
+
+When installed, Claude Code gains these tools:
+
+- **mnemex_search** - Semantic search across all indexed code
+- **mnemex_read** - Read file with intelligent chunking
+- **mnemex_store** - Store memories (decisions, patterns, findings)
+- **mnemex_recall** - Recall relevant memories
+- **mnemex_status** - Check mnemex status
+
+## Requirements
+
+- Node.js 16+
+- Claude Code CLI
+
+## Building from Source
+
+```bash
+git clone https://github.com/dgtise25/mnemex
+cd mnemex
+cargo build --release
+./target/release/mnemex install
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "mnemex",
+  "version": "1.0.0",
+  "description": "Memory Extension for AI Agents - Intelligent context optimization via semantic retrieval. MCP server for Claude Code.",
+  "bin": {
+    "mnemex": "./bin/mnemex"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "claude-code",
+    "ai",
+    "context-optimization",
+    "semantic-search",
+    "embeddings",
+    "rag",
+    "code-search",
+    "anthropic"
+  ],
+  "author": "lyle",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dgtise25/mnemex"
+  },
+  "homepage": "https://github.com/dgtise25/mnemex#readme",
+  "bugs": {
+    "url": "https://github.com/dgtise25/mnemex/issues"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "optionalDependencies": {
+    "@dgtise/mnemex-darwin-arm64": "1.0.0",
+    "@dgtise/mnemex-darwin-x64": "1.0.0",
+    "@dgtise/mnemex-linux-x64": "1.0.0",
+    "@dgtise/mnemex-linux-arm64": "1.0.0",
+    "@dgtise/mnemex-win32-x64": "1.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/packages/linux-x64/README.md

@@ -0,0 +1,11 @@
+# @mnemex/linux-x64
+
+Linux x64 binary for [mnemex](https://www.npmjs.com/package/mnemex).
+
+This package is installed automatically as an optional dependency. You should not install this package directly.
+
+## Install
+
+```bash
+npm install -g mnemex
+```

package/packages/linux-x64/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@dgtise/mnemex-linux-x64",
+  "version": "1.0.0",
+  "description": "Mnemex binary for Linux x64",
+  "os": ["linux"],
+  "cpu": ["x64"],
+  "main": "bin/mnemex",
+  "files": ["bin/mnemex"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dgtise25/mnemex"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/publish.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+# Publish mnemex to npm
+# Run this after `npm login`
+
+set -e
+
+cd "$(dirname "$0")"
+
+echo "Publishing @dgtise/mnemex-linux-x64..."
+cd packages/linux-x64
+npm publish --access public
+cd ../..
+
+echo ""
+echo "Publishing mnemex (main package)..."
+npm publish --access public
+
+echo ""
+echo "Done! Published:"
+echo "  - @dgtise/mnemex-linux-x64@1.0.0"
+echo "  - mnemex@1.0.0"
+echo ""
+echo "Users can now install with:"
+echo "  npm install -g mnemex"

package/scripts/postinstall.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const PLATFORM = os.platform();
+const ARCH = os.arch();
+
+// Map to package names
+const PLATFORM_MAP = {
+  'darwin-arm64': '@dgtise/mnemex-darwin-arm64',
+  'darwin-x64': '@dgtise/mnemex-darwin-x64',
+  'linux-x64': '@dgtise/mnemex-linux-x64',
+  'linux-arm64': '@dgtise/mnemex-linux-arm64',
+  'win32-x64': '@dgtise/mnemex-win32-x64',
+};
+
+const key = `${PLATFORM}-${ARCH}`;
+const pkgName = PLATFORM_MAP[key];
+
+if (!pkgName) {
+  console.error(`\n⚠ Unsupported platform: ${key}`);
+  console.error('Supported platforms: darwin-arm64, darwin-x64, linux-x64, linux-arm64, win32-x64');
+  console.error('\nYou can build from source:');
+  console.error('  git clone https://github.com/dgtise25/mnemex');
+  console.error('  cd mnemex && cargo build --release');
+  process.exit(1);
+}
+
+// Find the binary in the optional dependency
+try {
+  const pkgPath = require.resolve(`${pkgName}/package.json`);
+  const pkgDir = path.dirname(pkgPath);
+  const binName = PLATFORM === 'win32' ? 'mnemex.exe' : 'mnemex';
+  const srcBin = path.join(pkgDir, 'bin', binName);
+  const destBin = path.join(__dirname, '..', 'bin', binName);
+
+  // Check if source binary exists
+  if (!fs.existsSync(srcBin)) {
+    throw new Error(`Binary not found at ${srcBin}`);
+  }
+
+  // Ensure bin directory exists
+  fs.mkdirSync(path.dirname(destBin), { recursive: true });
+
+  // Copy binary
+  fs.copyFileSync(srcBin, destBin);
+  fs.chmodSync(destBin, 0o755);
+
+  console.log('\n✓ mnemex installed successfully');
+  console.log('\nTo configure Claude Code integration, run:');
+  console.log('  npx mnemex install');
+  console.log('\nThis will:');
+  console.log('  • Add mnemex to your Claude Code MCP servers');
+  console.log('  • Enable auto-indexing on first search');
+  console.log('  • Reduce context window usage by 90%+\n');
+} catch (err) {
+  // Check if the platform package wasn't installed (expected for unsupported platforms)
+  if (err.code === 'MODULE_NOT_FOUND') {
+    console.error(`\n⚠ Platform package ${pkgName} not found.`);
+    console.error('This platform may not be supported yet.\n');
+  } else {
+    console.error(`\n⚠ Failed to install mnemex binary: ${err.message}`);
+  }
+  console.error('You can build from source instead:');
+  console.error('  git clone https://github.com/dgtise25/mnemex');
+  console.error('  cd mnemex && cargo build --release\n');
+  process.exit(1);
+}