feat: remove old installer, update docs to npx claude-mem

Removes installer/ directory (16 files) — fully replaced by src/npx-cli/.
Updates install.sh and installer.js to redirect to npx claude-mem.
Adds npx claude-mem as primary install method in docs and README.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Alex Newman
2026-02-27 00:13:45 -05:00
parent 031513d723
commit 88636ec012
24 changed files with 64 additions and 5429 deletions

1
.gitignore vendored
View File

@@ -1,7 +1,6 @@
datasets/
node_modules/
dist/
!installer/dist/
**/_tree-sitter/
*.log
.DS_Store

View File

@@ -5,7 +5,6 @@ tests/
docs/
datasets/
private/
installer/
antipattern-czar/
# Heavy binaries installed at runtime via smart-install.js

View File

@@ -127,7 +127,13 @@
## Quick Start
Start a new Claude Code session in the terminal and enter the following commands:
Install with a single command:
```bash
npx claude-mem install
```
Or install from the plugin marketplace inside Claude Code:
```
/plugin marketplace add thedotmack/claude-mem
@@ -137,7 +143,7 @@ Start a new Claude Code session in the terminal and enter the following commands
Restart Claude Code. Context from previous sessions will automatically appear in new sessions.
> **Note:** Claude-Mem is also published on npm, but `npm install -g claude-mem` installs the **SDK/library only** — it does not register the plugin hooks or set up the worker service. To use Claude-Mem as a plugin, always install via the `/plugin` commands above.
> **Note:** Claude-Mem is also published on npm, but `npm install -g claude-mem` installs the **SDK/library only** — it does not register the plugin hooks or set up the worker service. Always install via `npx claude-mem install` or the `/plugin` commands above.
### 🦞 OpenClaw Gateway

View File

@@ -7,24 +7,35 @@ description: "Install Claude-Mem plugin for persistent memory across sessions"
## Quick Start
Install Claude-Mem directly from the plugin marketplace:
### Option 1: npx (Recommended)
Install and configure Claude-Mem with a single command:
```bash
npx claude-mem install
```
The interactive installer will:
- Detect your installed IDEs (Claude Code, Cursor, Gemini CLI, Windsurf, etc.)
- Copy plugin files to the correct locations
- Register the plugin with Claude Code
- Install all dependencies (including Bun and uv)
- Auto-start the worker service
### Option 2: Plugin Marketplace
Install Claude-Mem directly from the plugin marketplace inside Claude Code:
```bash
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
```
That's it! The plugin will automatically:
- Download prebuilt binaries (no compilation needed)
- Install all dependencies (including SQLite binaries)
- Configure hooks for session lifecycle management
- Auto-start the worker service on first session
Start a new Claude Code session and you'll see context from previous sessions automatically loaded.
Both methods will automatically configure hooks and start the worker service. Start a new Claude Code session and you'll see context from previous sessions automatically loaded.
> **Important:** Claude-Mem is published on npm, but running `npm install -g claude-mem` installs the
> **SDK/library only**. It does **not** register plugin hooks or start the worker service.
> To use Claude-Mem as a persistent memory plugin, always install via the `/plugin` commands above.
> Always install via `npx claude-mem install` or the `/plugin` commands above.
## System Requirements

View File

@@ -11,7 +11,13 @@ Claude-Mem seamlessly preserves context across sessions by automatically capturi
## Quick Start
Start a new Claude Code session in the terminal and enter the following commands:
Install with a single command:
```bash
npx claude-mem install
```
Or install from the plugin marketplace inside Claude Code:
```bash
/plugin marketplace add thedotmack/claude-mem

View File

@@ -1,59 +1,25 @@
#!/bin/bash
set -euo pipefail
# claude-mem installer bootstrap
# Usage: curl -fsSL https://install.cmem.ai | bash
# or: curl -fsSL https://install.cmem.ai | bash -s -- --provider=gemini --api-key=YOUR_KEY
INSTALLER_URL="https://install.cmem.ai/installer.js"
# claude-mem installer redirect
# The old curl-pipe-bash installer has been replaced by npx claude-mem.
# This script now redirects users to the new install method.
# Colors
RED='\033[0;31m'
GREEN='\033[0;32m'
CYAN='\033[0;36m'
YELLOW='\033[0;33m'
NC='\033[0m' # No Color
error() { echo -e "${RED}Error: $1${NC}" >&2; exit 1; }
info() { echo -e "${CYAN}$1${NC}"; }
# Check Node.js
if ! command -v node &> /dev/null; then
error "Node.js is required but not found. Install from https://nodejs.org"
fi
NODE_VERSION=$(node -v | sed 's/v//')
NODE_MAJOR=$(echo "$NODE_VERSION" | cut -d. -f1)
if [ "$NODE_MAJOR" -lt 18 ]; then
error "Node.js >= 18 required. Current: v${NODE_VERSION}"
fi
info "claude-mem installer (Node.js v${NODE_VERSION})"
# Create temp file for installer
TMPFILE=$(mktemp "${TMPDIR:-/tmp}/claude-mem-installer.XXXXXX.mjs")
# Cleanup on exit
cleanup() {
rm -f "$TMPFILE"
}
trap cleanup EXIT INT TERM
# Download installer
info "Downloading installer..."
if command -v curl &> /dev/null; then
curl -fsSL "$INSTALLER_URL" -o "$TMPFILE"
elif command -v wget &> /dev/null; then
wget -q "$INSTALLER_URL" -O "$TMPFILE"
else
error "curl or wget required to download installer"
fi
# Run installer with TTY access
# When piped (curl | bash), stdin is the script. We need to reconnect to the terminal.
if [ -t 0 ]; then
# Already have TTY (script was downloaded and run directly)
node "$TMPFILE" "$@"
else
# Piped execution -- reconnect stdin to terminal
node "$TMPFILE" "$@" </dev/tty
fi
echo ""
echo -e "${YELLOW}The curl-pipe-bash installer has been replaced.${NC}"
echo ""
echo -e "${GREEN}Install claude-mem with a single command:${NC}"
echo ""
echo -e " ${CYAN}npx claude-mem install${NC}"
echo ""
echo -e "This requires Node.js >= 18. Get it from ${CYAN}https://nodejs.org${NC}"
echo ""
echo -e "For more info, visit: ${CYAN}https://docs.claude-mem.ai/installation${NC}"
echo ""

File diff suppressed because it is too large Load Diff

View File

@@ -1,16 +0,0 @@
import { build } from 'esbuild';
await build({
entryPoints: ['src/index.ts'],
bundle: true,
format: 'esm',
platform: 'node',
target: 'node18',
outfile: 'dist/index.js',
banner: {
js: '#!/usr/bin/env node',
},
external: [],
});
console.log('Build complete: dist/index.js');

2107
installer/dist/index.js vendored

File diff suppressed because it is too large Load Diff

View File

@@ -1,21 +0,0 @@
{
"name": "claude-mem-installer",
"version": "1.0.0",
"type": "module",
"bin": { "claude-mem-installer": "./dist/index.js" },
"files": ["dist"],
"scripts": {
"build": "node build.mjs",
"dev": "node build.mjs && node dist/index.js"
},
"dependencies": {
"@clack/prompts": "^1.0.1",
"picocolors": "^1.1.1"
},
"devDependencies": {
"esbuild": "^0.24.0",
"typescript": "^5.7.0",
"@types/node": "^22.0.0"
},
"engines": { "node": ">=18.0.0" }
}

View File

@@ -1,49 +0,0 @@
import * as p from '@clack/prompts';
import { runWelcome } from './steps/welcome.js';
import { runDependencyChecks } from './steps/dependencies.js';
import { runIdeSelection } from './steps/ide-selection.js';
import { runProviderConfiguration } from './steps/provider.js';
import { runSettingsConfiguration } from './steps/settings.js';
import { writeSettings } from './utils/settings-writer.js';
import { runInstallation } from './steps/install.js';
import { runWorkerStartup } from './steps/worker.js';
import { runCompletion } from './steps/complete.js';
async function runInstaller(): Promise<void> {
if (!process.stdin.isTTY) {
console.error('Error: This installer requires an interactive terminal.');
console.error('Run directly: npx claude-mem-installer');
process.exit(1);
}
const installMode = await runWelcome();
// Dependency checks (all modes)
await runDependencyChecks();
// IDE and provider selection
const selectedIDEs = await runIdeSelection();
const providerConfig = await runProviderConfiguration();
// Settings configuration
const settingsConfig = await runSettingsConfiguration();
// Write settings file
writeSettings(providerConfig, settingsConfig);
p.log.success('Settings saved.');
// Installation (fresh or upgrade)
if (installMode !== 'configure') {
await runInstallation(selectedIDEs);
await runWorkerStartup(settingsConfig.workerPort, settingsConfig.dataDir);
}
// Completion summary
runCompletion(providerConfig, settingsConfig, selectedIDEs);
}
runInstaller().catch((error) => {
p.cancel('Installation failed.');
console.error(error);
process.exit(1);
});

View File

@@ -1,56 +0,0 @@
import * as p from '@clack/prompts';
import pc from 'picocolors';
import type { ProviderConfig } from './provider.js';
import type { SettingsConfig } from './settings.js';
import type { IDE } from './ide-selection.js';
function getProviderLabel(config: ProviderConfig): string {
switch (config.provider) {
case 'claude':
return config.claudeAuthMethod === 'api' ? 'Claude (API Key)' : 'Claude (CLI subscription)';
case 'gemini':
return `Gemini (${config.model ?? 'gemini-2.5-flash-lite'})`;
case 'openrouter':
return `OpenRouter (${config.model ?? 'xiaomi/mimo-v2-flash:free'})`;
}
}
function getIDELabels(ides: IDE[]): string {
return ides.map((ide) => {
switch (ide) {
case 'claude-code': return 'Claude Code';
case 'cursor': return 'Cursor';
}
}).join(', ');
}
export function runCompletion(
providerConfig: ProviderConfig,
settingsConfig: SettingsConfig,
selectedIDEs: IDE[],
): void {
const summaryLines = [
`Provider: ${pc.cyan(getProviderLabel(providerConfig))}`,
`IDEs: ${pc.cyan(getIDELabels(selectedIDEs))}`,
`Data dir: ${pc.cyan(settingsConfig.dataDir)}`,
`Port: ${pc.cyan(settingsConfig.workerPort)}`,
`Chroma: ${settingsConfig.chromaEnabled ? pc.green('enabled') : pc.dim('disabled')}`,
];
p.note(summaryLines.join('\n'), 'Configuration Summary');
const nextStepsLines: string[] = [];
if (selectedIDEs.includes('claude-code')) {
nextStepsLines.push('Open Claude Code and start a conversation — memory is automatic!');
}
if (selectedIDEs.includes('cursor')) {
nextStepsLines.push('Open Cursor — hooks are active in your projects.');
}
nextStepsLines.push(`View your memories: ${pc.underline(`http://localhost:${settingsConfig.workerPort}`)}`);
nextStepsLines.push(`Search past work: use ${pc.bold('/mem-search')} in Claude Code`);
p.note(nextStepsLines.join('\n'), 'Next Steps');
p.outro(pc.green('claude-mem installed successfully!'));
}

View File

@@ -1,168 +0,0 @@
import * as p from '@clack/prompts';
import pc from 'picocolors';
import { findBinary, compareVersions, installBun, installUv } from '../utils/dependencies.js';
import { detectOS } from '../utils/system.js';
const BUN_EXTRA_PATHS = ['~/.bun/bin/bun', '/usr/local/bin/bun', '/opt/homebrew/bin/bun'];
const UV_EXTRA_PATHS = ['~/.local/bin/uv', '~/.cargo/bin/uv'];
interface DependencyStatus {
nodeOk: boolean;
gitOk: boolean;
bunOk: boolean;
uvOk: boolean;
bunPath: string | null;
uvPath: string | null;
}
export async function runDependencyChecks(): Promise<DependencyStatus> {
const status: DependencyStatus = {
nodeOk: false,
gitOk: false,
bunOk: false,
uvOk: false,
bunPath: null,
uvPath: null,
};
await p.tasks([
{
title: 'Checking Node.js',
task: async () => {
const version = process.version.slice(1); // remove 'v'
if (compareVersions(version, '18.0.0')) {
status.nodeOk = true;
return `Node.js ${process.version} ${pc.green('✓')}`;
}
return `Node.js ${process.version} — requires >= 18.0.0 ${pc.red('✗')}`;
},
},
{
title: 'Checking git',
task: async () => {
const info = findBinary('git');
if (info.found) {
status.gitOk = true;
return `git ${info.version ?? ''} ${pc.green('✓')}`;
}
return `git not found ${pc.red('✗')}`;
},
},
{
title: 'Checking Bun',
task: async () => {
const info = findBinary('bun', BUN_EXTRA_PATHS);
if (info.found && info.version && compareVersions(info.version, '1.1.14')) {
status.bunOk = true;
status.bunPath = info.path;
return `Bun ${info.version} ${pc.green('✓')}`;
}
if (info.found && info.version) {
return `Bun ${info.version} — requires >= 1.1.14 ${pc.yellow('⚠')}`;
}
return `Bun not found ${pc.yellow('⚠')}`;
},
},
{
title: 'Checking uv',
task: async () => {
const info = findBinary('uv', UV_EXTRA_PATHS);
if (info.found) {
status.uvOk = true;
status.uvPath = info.path;
return `uv ${info.version ?? ''} ${pc.green('✓')}`;
}
return `uv not found ${pc.yellow('⚠')}`;
},
},
]);
// Handle missing dependencies
if (!status.gitOk) {
const os = detectOS();
p.log.error('git is required but not found.');
if (os === 'macos') {
p.log.info('Install with: xcode-select --install');
} else if (os === 'linux') {
p.log.info('Install with: sudo apt install git (or your distro equivalent)');
} else {
p.log.info('Download from: https://git-scm.com/downloads');
}
p.cancel('Please install git and try again.');
process.exit(1);
}
if (!status.nodeOk) {
p.log.error(`Node.js >= 18.0.0 is required. Current: ${process.version}`);
p.cancel('Please upgrade Node.js and try again.');
process.exit(1);
}
if (!status.bunOk) {
const shouldInstall = await p.confirm({
message: 'Bun is required but not found. Install it now?',
initialValue: true,
});
if (p.isCancel(shouldInstall)) {
p.cancel('Installation cancelled.');
process.exit(0);
}
if (shouldInstall) {
const s = p.spinner();
s.start('Installing Bun...');
try {
installBun();
const recheck = findBinary('bun', BUN_EXTRA_PATHS);
if (recheck.found) {
status.bunOk = true;
status.bunPath = recheck.path;
s.stop(`Bun installed ${pc.green('✓')}`);
} else {
s.stop(`Bun installed but not found in PATH. You may need to restart your shell.`);
}
} catch {
s.stop(`Bun installation failed. Install manually: curl -fsSL https://bun.sh/install | bash`);
}
} else {
p.log.warn('Bun is required for claude-mem. Install manually: curl -fsSL https://bun.sh/install | bash');
p.cancel('Cannot continue without Bun.');
process.exit(1);
}
}
if (!status.uvOk) {
const shouldInstall = await p.confirm({
message: 'uv (Python package manager) is recommended for Chroma. Install it now?',
initialValue: true,
});
if (p.isCancel(shouldInstall)) {
p.cancel('Installation cancelled.');
process.exit(0);
}
if (shouldInstall) {
const s = p.spinner();
s.start('Installing uv...');
try {
installUv();
const recheck = findBinary('uv', UV_EXTRA_PATHS);
if (recheck.found) {
status.uvOk = true;
status.uvPath = recheck.path;
s.stop(`uv installed ${pc.green('✓')}`);
} else {
s.stop('uv installed but not found in PATH. You may need to restart your shell.');
}
} catch {
s.stop('uv installation failed. Install manually: curl -fsSL https://astral.sh/uv/install.sh | sh');
}
} else {
p.log.warn('Skipping uv — Chroma vector search will not be available.');
}
}
return status;
}

View File

@@ -1,32 +0,0 @@
import * as p from '@clack/prompts';
export type IDE = 'claude-code' | 'cursor';
export async function runIdeSelection(): Promise<IDE[]> {
const result = await p.multiselect({
message: 'Which IDEs do you use?',
options: [
{ value: 'claude-code' as const, label: 'Claude Code', hint: 'recommended' },
{ value: 'cursor' as const, label: 'Cursor' },
// Windsurf coming soon - not yet selectable
],
initialValues: ['claude-code'],
required: true,
});
if (p.isCancel(result)) {
p.cancel('Installation cancelled.');
process.exit(0);
}
const selectedIDEs = result as IDE[];
if (selectedIDEs.includes('claude-code')) {
p.log.info('Claude Code: Plugin will be registered via marketplace.');
}
if (selectedIDEs.includes('cursor')) {
p.log.info('Cursor: Hooks will be configured for your projects.');
}
return selectedIDEs;
}

View File

@@ -1,167 +0,0 @@
import * as p from '@clack/prompts';
import pc from 'picocolors';
import { execSync } from 'child_process';
import { existsSync, mkdirSync, readFileSync, writeFileSync, cpSync } from 'fs';
import { join } from 'path';
import { homedir, tmpdir } from 'os';
import type { IDE } from './ide-selection.js';
const MARKETPLACE_DIR = join(homedir(), '.claude', 'plugins', 'marketplaces', 'thedotmack');
const PLUGINS_DIR = join(homedir(), '.claude', 'plugins');
const CLAUDE_SETTINGS_PATH = join(homedir(), '.claude', 'settings.json');
function ensureDir(directoryPath: string): void {
if (!existsSync(directoryPath)) {
mkdirSync(directoryPath, { recursive: true });
}
}
function readJsonFile(filepath: string): any {
if (!existsSync(filepath)) return {};
return JSON.parse(readFileSync(filepath, 'utf-8'));
}
function writeJsonFile(filepath: string, data: any): void {
ensureDir(join(filepath, '..'));
writeFileSync(filepath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
}
function registerMarketplace(): void {
const knownMarketplacesPath = join(PLUGINS_DIR, 'known_marketplaces.json');
const knownMarketplaces = readJsonFile(knownMarketplacesPath);
knownMarketplaces['thedotmack'] = {
source: {
source: 'github',
repo: 'thedotmack/claude-mem',
},
installLocation: MARKETPLACE_DIR,
lastUpdated: new Date().toISOString(),
autoUpdate: true,
};
ensureDir(PLUGINS_DIR);
writeJsonFile(knownMarketplacesPath, knownMarketplaces);
}
function registerPlugin(version: string): void {
const installedPluginsPath = join(PLUGINS_DIR, 'installed_plugins.json');
const installedPlugins = readJsonFile(installedPluginsPath);
if (!installedPlugins.version) installedPlugins.version = 2;
if (!installedPlugins.plugins) installedPlugins.plugins = {};
const pluginCachePath = join(PLUGINS_DIR, 'cache', 'thedotmack', 'claude-mem', version);
const now = new Date().toISOString();
installedPlugins.plugins['claude-mem@thedotmack'] = [
{
scope: 'user',
installPath: pluginCachePath,
version,
installedAt: now,
lastUpdated: now,
},
];
writeJsonFile(installedPluginsPath, installedPlugins);
// Copy built plugin to cache directory
ensureDir(pluginCachePath);
const pluginSourceDir = join(MARKETPLACE_DIR, 'plugin');
if (existsSync(pluginSourceDir)) {
cpSync(pluginSourceDir, pluginCachePath, { recursive: true });
}
}
function enablePluginInClaudeSettings(): void {
const settings = readJsonFile(CLAUDE_SETTINGS_PATH);
if (!settings.enabledPlugins) settings.enabledPlugins = {};
settings.enabledPlugins['claude-mem@thedotmack'] = true;
writeJsonFile(CLAUDE_SETTINGS_PATH, settings);
}
function getPluginVersion(): string {
const pluginJsonPath = join(MARKETPLACE_DIR, 'plugin', '.claude-plugin', 'plugin.json');
if (existsSync(pluginJsonPath)) {
const pluginJson = JSON.parse(readFileSync(pluginJsonPath, 'utf-8'));
return pluginJson.version ?? '1.0.0';
}
return '1.0.0';
}
export async function runInstallation(selectedIDEs: IDE[]): Promise<void> {
const tempDir = join(tmpdir(), `claude-mem-install-${Date.now()}`);
await p.tasks([
{
title: 'Cloning claude-mem repository',
task: async (message) => {
message('Downloading latest release...');
execSync(
`git clone --depth 1 https://github.com/thedotmack/claude-mem.git "${tempDir}"`,
{ stdio: 'pipe' },
);
return `Repository cloned ${pc.green('OK')}`;
},
},
{
title: 'Installing dependencies',
task: async (message) => {
message('Running npm install...');
execSync('npm install', { cwd: tempDir, stdio: 'pipe' });
return `Dependencies installed ${pc.green('OK')}`;
},
},
{
title: 'Building plugin',
task: async (message) => {
message('Compiling TypeScript and bundling...');
execSync('npm run build', { cwd: tempDir, stdio: 'pipe' });
return `Plugin built ${pc.green('OK')}`;
},
},
{
title: 'Registering plugin',
task: async (message) => {
message('Copying files to marketplace directory...');
ensureDir(MARKETPLACE_DIR);
// Sync from cloned repo to marketplace dir, excluding .git and lock files
execSync(
`rsync -a --delete --exclude=.git --exclude=package-lock.json --exclude=bun.lock "${tempDir}/" "${MARKETPLACE_DIR}/"`,
{ stdio: 'pipe' },
);
message('Registering marketplace...');
registerMarketplace();
message('Installing marketplace dependencies...');
execSync('npm install', { cwd: MARKETPLACE_DIR, stdio: 'pipe' });
message('Registering plugin in Claude Code...');
const version = getPluginVersion();
registerPlugin(version);
message('Enabling plugin...');
enablePluginInClaudeSettings();
return `Plugin registered (v${getPluginVersion()}) ${pc.green('OK')}`;
},
},
]);
// Cleanup temp directory (non-critical if it fails)
try {
execSync(`rm -rf "${tempDir}"`, { stdio: 'pipe' });
} catch {
// Temp dir will be cleaned by OS eventually
}
if (selectedIDEs.includes('cursor')) {
p.log.info('Cursor hook configuration will be available after first launch.');
p.log.info('Run: claude-mem cursor-setup (coming soon)');
}
}

View File

@@ -1,140 +0,0 @@
import * as p from '@clack/prompts';
import pc from 'picocolors';
export type ProviderType = 'claude' | 'gemini' | 'openrouter';
export type ClaudeAuthMethod = 'cli' | 'api';
export interface ProviderConfig {
provider: ProviderType;
claudeAuthMethod?: ClaudeAuthMethod;
apiKey?: string;
model?: string;
rateLimitingEnabled?: boolean;
}
export async function runProviderConfiguration(): Promise<ProviderConfig> {
const provider = await p.select({
message: 'Which AI provider should claude-mem use for memory compression?',
options: [
{ value: 'claude' as const, label: 'Claude', hint: 'uses your Claude subscription' },
{ value: 'gemini' as const, label: 'Gemini', hint: 'free tier available' },
{ value: 'openrouter' as const, label: 'OpenRouter', hint: 'free models available' },
],
});
if (p.isCancel(provider)) {
p.cancel('Installation cancelled.');
process.exit(0);
}
const config: ProviderConfig = { provider };
if (provider === 'claude') {
const authMethod = await p.select({
message: 'How should Claude authenticate?',
options: [
{ value: 'cli' as const, label: 'CLI (Max Plan subscription)', hint: 'no API key needed' },
{ value: 'api' as const, label: 'API Key', hint: 'uses Anthropic API credits' },
],
});
if (p.isCancel(authMethod)) {
p.cancel('Installation cancelled.');
process.exit(0);
}
config.claudeAuthMethod = authMethod;
if (authMethod === 'api') {
const apiKey = await p.password({
message: 'Enter your Anthropic API key:',
validate: (value) => {
if (!value || value.trim().length === 0) return 'API key is required';
if (!value.startsWith('sk-ant-')) return 'Anthropic API keys start with sk-ant-';
},
});
if (p.isCancel(apiKey)) {
p.cancel('Installation cancelled.');
process.exit(0);
}
config.apiKey = apiKey;
}
}
if (provider === 'gemini') {
const apiKey = await p.password({
message: 'Enter your Gemini API key:',
validate: (value) => {
if (!value || value.trim().length === 0) return 'API key is required';
},
});
if (p.isCancel(apiKey)) {
p.cancel('Installation cancelled.');
process.exit(0);
}
config.apiKey = apiKey;
const model = await p.select({
message: 'Which Gemini model?',
options: [
{ value: 'gemini-2.5-flash-lite' as const, label: 'Gemini 2.5 Flash Lite', hint: 'fastest, highest free RPM' },
{ value: 'gemini-2.5-flash' as const, label: 'Gemini 2.5 Flash', hint: 'balanced' },
{ value: 'gemini-3-flash-preview' as const, label: 'Gemini 3 Flash Preview', hint: 'latest' },
],
});
if (p.isCancel(model)) {
p.cancel('Installation cancelled.');
process.exit(0);
}
config.model = model;
const rateLimiting = await p.confirm({
message: 'Enable rate limiting? (recommended for free tier)',
initialValue: true,
});
if (p.isCancel(rateLimiting)) {
p.cancel('Installation cancelled.');
process.exit(0);
}
config.rateLimitingEnabled = rateLimiting;
}
if (provider === 'openrouter') {
const apiKey = await p.password({
message: 'Enter your OpenRouter API key:',
validate: (value) => {
if (!value || value.trim().length === 0) return 'API key is required';
},
});
if (p.isCancel(apiKey)) {
p.cancel('Installation cancelled.');
process.exit(0);
}
config.apiKey = apiKey;
const model = await p.text({
message: 'Which OpenRouter model?',
defaultValue: 'xiaomi/mimo-v2-flash:free',
placeholder: 'xiaomi/mimo-v2-flash:free',
});
if (p.isCancel(model)) {
p.cancel('Installation cancelled.');
process.exit(0);
}
config.model = model;
}
return config;
}

View File

@@ -1,174 +0,0 @@
import * as p from '@clack/prompts';
import pc from 'picocolors';
export interface SettingsConfig {
workerPort: string;
dataDir: string;
contextObservations: string;
logLevel: string;
pythonVersion: string;
chromaEnabled: boolean;
chromaMode?: 'local' | 'remote';
chromaHost?: string;
chromaPort?: string;
chromaSsl?: boolean;
}
export async function runSettingsConfiguration(): Promise<SettingsConfig> {
const useDefaults = await p.confirm({
message: 'Use default settings? (recommended for most users)',
initialValue: true,
});
if (p.isCancel(useDefaults)) {
p.cancel('Installation cancelled.');
process.exit(0);
}
if (useDefaults) {
return {
workerPort: '37777',
dataDir: '~/.claude-mem',
contextObservations: '50',
logLevel: 'INFO',
pythonVersion: '3.13',
chromaEnabled: true,
chromaMode: 'local',
};
}
// Custom settings
const workerPort = await p.text({
message: 'Worker service port:',
defaultValue: '37777',
placeholder: '37777',
validate: (value = '') => {
const port = parseInt(value, 10);
if (isNaN(port) || port < 1024 || port > 65535) {
return 'Port must be between 1024 and 65535';
}
},
});
if (p.isCancel(workerPort)) { p.cancel('Installation cancelled.'); process.exit(0); }
const dataDir = await p.text({
message: 'Data directory:',
defaultValue: '~/.claude-mem',
placeholder: '~/.claude-mem',
});
if (p.isCancel(dataDir)) { p.cancel('Installation cancelled.'); process.exit(0); }
const contextObservations = await p.text({
message: 'Number of context observations per session:',
defaultValue: '50',
placeholder: '50',
validate: (value = '') => {
const num = parseInt(value, 10);
if (isNaN(num) || num < 1 || num > 200) {
return 'Must be between 1 and 200';
}
},
});
if (p.isCancel(contextObservations)) { p.cancel('Installation cancelled.'); process.exit(0); }
const logLevel = await p.select({
message: 'Log level:',
options: [
{ value: 'DEBUG', label: 'DEBUG', hint: 'verbose' },
{ value: 'INFO', label: 'INFO', hint: 'default' },
{ value: 'WARN', label: 'WARN' },
{ value: 'ERROR', label: 'ERROR', hint: 'errors only' },
],
initialValue: 'INFO',
});
if (p.isCancel(logLevel)) { p.cancel('Installation cancelled.'); process.exit(0); }
const pythonVersion = await p.text({
message: 'Python version (for Chroma):',
defaultValue: '3.13',
placeholder: '3.13',
});
if (p.isCancel(pythonVersion)) { p.cancel('Installation cancelled.'); process.exit(0); }
const chromaEnabled = await p.confirm({
message: 'Enable Chroma vector search?',
initialValue: true,
});
if (p.isCancel(chromaEnabled)) { p.cancel('Installation cancelled.'); process.exit(0); }
let chromaMode: 'local' | 'remote' | undefined;
let chromaHost: string | undefined;
let chromaPort: string | undefined;
let chromaSsl: boolean | undefined;
if (chromaEnabled) {
const mode = await p.select({
message: 'Chroma mode:',
options: [
{ value: 'local' as const, label: 'Local', hint: 'starts local Chroma server' },
{ value: 'remote' as const, label: 'Remote', hint: 'connect to existing server' },
],
});
if (p.isCancel(mode)) { p.cancel('Installation cancelled.'); process.exit(0); }
chromaMode = mode;
if (mode === 'remote') {
const host = await p.text({
message: 'Chroma host:',
defaultValue: '127.0.0.1',
placeholder: '127.0.0.1',
});
if (p.isCancel(host)) { p.cancel('Installation cancelled.'); process.exit(0); }
chromaHost = host;
const port = await p.text({
message: 'Chroma port:',
defaultValue: '8000',
placeholder: '8000',
validate: (value = '') => {
const portNum = parseInt(value, 10);
if (isNaN(portNum) || portNum < 1 || portNum > 65535) return 'Port must be between 1 and 65535';
},
});
if (p.isCancel(port)) { p.cancel('Installation cancelled.'); process.exit(0); }
chromaPort = port;
const ssl = await p.confirm({
message: 'Use SSL for Chroma connection?',
initialValue: false,
});
if (p.isCancel(ssl)) { p.cancel('Installation cancelled.'); process.exit(0); }
chromaSsl = ssl;
}
}
const config: SettingsConfig = {
workerPort,
dataDir,
contextObservations,
logLevel,
pythonVersion,
chromaEnabled,
chromaMode,
chromaHost,
chromaPort,
chromaSsl,
};
// Show summary
const summaryLines = [
`Worker port: ${pc.cyan(workerPort)}`,
`Data directory: ${pc.cyan(dataDir)}`,
`Context observations: ${pc.cyan(contextObservations)}`,
`Log level: ${pc.cyan(logLevel)}`,
`Python version: ${pc.cyan(pythonVersion)}`,
`Chroma: ${chromaEnabled ? pc.green('enabled') : pc.dim('disabled')}`,
];
if (chromaEnabled && chromaMode) {
summaryLines.push(`Chroma mode: ${pc.cyan(chromaMode)}`);
}
p.note(summaryLines.join('\n'), 'Settings Summary');
return config;
}

View File

@@ -1,43 +0,0 @@
import * as p from '@clack/prompts';
import pc from 'picocolors';
import { existsSync } from 'fs';
import { expandHome } from '../utils/system.js';
export type InstallMode = 'fresh' | 'upgrade' | 'configure';
export async function runWelcome(): Promise<InstallMode> {
p.intro(pc.bgCyan(pc.black(' claude-mem installer ')));
p.log.info(`Version: 1.0.0`);
p.log.info(`Platform: ${process.platform} (${process.arch})`);
const settingsExist = existsSync(expandHome('~/.claude-mem/settings.json'));
const pluginExist = existsSync(expandHome('~/.claude/plugins/marketplaces/thedotmack/'));
const alreadyInstalled = settingsExist && pluginExist;
if (alreadyInstalled) {
p.log.warn('Existing claude-mem installation detected.');
}
const installMode = await p.select({
message: 'What would you like to do?',
options: alreadyInstalled
? [
{ value: 'upgrade' as const, label: 'Upgrade', hint: 'update to latest version' },
{ value: 'configure' as const, label: 'Configure', hint: 'change settings only' },
{ value: 'fresh' as const, label: 'Fresh Install', hint: 'reinstall from scratch' },
]
: [
{ value: 'fresh' as const, label: 'Fresh Install', hint: 'recommended' },
{ value: 'configure' as const, label: 'Configure Only', hint: 'set up settings without installing' },
],
});
if (p.isCancel(installMode)) {
p.cancel('Installation cancelled.');
process.exit(0);
}
return installMode;
}

View File

@@ -1,67 +0,0 @@
import * as p from '@clack/prompts';
import pc from 'picocolors';
import { spawn } from 'child_process';
import { join } from 'path';
import { homedir } from 'os';
import { expandHome } from '../utils/system.js';
import { findBinary } from '../utils/dependencies.js';
const MARKETPLACE_DIR = join(homedir(), '.claude', 'plugins', 'marketplaces', 'thedotmack');
const HEALTH_CHECK_INTERVAL_MS = 1000;
const HEALTH_CHECK_MAX_ATTEMPTS = 30;
async function pollHealthEndpoint(port: string, maxAttempts: number = HEALTH_CHECK_MAX_ATTEMPTS): Promise<boolean> {
for (let attempt = 0; attempt < maxAttempts; attempt++) {
try {
const response = await fetch(`http://127.0.0.1:${port}/api/health`);
if (response.ok) return true;
} catch {
// Expected during startup — worker not listening yet
}
await new Promise((resolve) => setTimeout(resolve, HEALTH_CHECK_INTERVAL_MS));
}
return false;
}
export async function runWorkerStartup(workerPort: string, dataDir: string): Promise<void> {
const bunInfo = findBinary('bun', ['~/.bun/bin/bun', '/usr/local/bin/bun', '/opt/homebrew/bin/bun']);
if (!bunInfo.found || !bunInfo.path) {
p.log.error('Bun is required to start the worker but was not found.');
p.log.info('Install Bun: curl -fsSL https://bun.sh/install | bash');
return;
}
const workerScript = join(MARKETPLACE_DIR, 'plugin', 'scripts', 'worker-service.cjs');
const expandedDataDir = expandHome(dataDir);
const logPath = join(expandedDataDir, 'logs');
const s = p.spinner();
s.start('Starting worker service...');
// Start worker as a detached background process
const child = spawn(bunInfo.path, [workerScript], {
cwd: MARKETPLACE_DIR,
detached: true,
stdio: 'ignore',
env: {
...process.env,
CLAUDE_MEM_WORKER_PORT: workerPort,
CLAUDE_MEM_DATA_DIR: expandedDataDir,
},
});
child.unref();
// Poll the health endpoint until the worker is responsive
const workerIsHealthy = await pollHealthEndpoint(workerPort);
if (workerIsHealthy) {
s.stop(`Worker running on port ${pc.cyan(workerPort)} ${pc.green('OK')}`);
} else {
s.stop(`Worker may still be starting. Check logs at: ${logPath}`);
p.log.warn('Health check timed out. The worker might need more time to initialize.');
p.log.info(`Check status: curl http://127.0.0.1:${workerPort}/api/health`);
}
}

View File

@@ -1,74 +0,0 @@
import { existsSync } from 'fs';
import { execSync } from 'child_process';
import { commandExists, runCommand, expandHome, detectOS } from './system.js';
export interface BinaryInfo {
found: boolean;
path: string | null;
version: string | null;
}
export function findBinary(name: string, extraPaths: string[] = []): BinaryInfo {
// Check PATH first
if (commandExists(name)) {
const result = runCommand('which', [name]);
const versionResult = runCommand(name, ['--version']);
return {
found: true,
path: result.stdout,
version: parseVersion(versionResult.stdout) || parseVersion(versionResult.stderr),
};
}
// Check extra known locations
for (const extraPath of extraPaths) {
const fullPath = expandHome(extraPath);
if (existsSync(fullPath)) {
const versionResult = runCommand(fullPath, ['--version']);
return {
found: true,
path: fullPath,
version: parseVersion(versionResult.stdout) || parseVersion(versionResult.stderr),
};
}
}
return { found: false, path: null, version: null };
}
function parseVersion(output: string): string | null {
if (!output) return null;
const match = output.match(/(\d+\.\d+(\.\d+)?)/);
return match ? match[1] : null;
}
export function compareVersions(current: string, minimum: string): boolean {
const currentParts = current.split('.').map(Number);
const minimumParts = minimum.split('.').map(Number);
for (let i = 0; i < Math.max(currentParts.length, minimumParts.length); i++) {
const a = currentParts[i] || 0;
const b = minimumParts[i] || 0;
if (a > b) return true;
if (a < b) return false;
}
return true; // equal
}
export function installBun(): void {
const os = detectOS();
if (os === 'windows') {
execSync('powershell -c "irm bun.sh/install.ps1 | iex"', { stdio: 'inherit' });
} else {
execSync('curl -fsSL https://bun.sh/install | bash', { stdio: 'inherit' });
}
}
export function installUv(): void {
const os = detectOS();
if (os === 'windows') {
execSync('powershell -c "irm https://astral.sh/uv/install.ps1 | iex"', { stdio: 'inherit' });
} else {
execSync('curl -fsSL https://astral.sh/uv/install.sh | sh', { stdio: 'inherit' });
}
}

View File

@@ -1,82 +0,0 @@
import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
import { join } from 'path';
import { homedir } from 'os';
import type { ProviderConfig } from '../steps/provider.js';
import type { SettingsConfig } from '../steps/settings.js';
export function expandDataDir(dataDir: string): string {
if (dataDir.startsWith('~')) {
return join(homedir(), dataDir.slice(1));
}
return dataDir;
}
export function buildSettingsObject(
providerConfig: ProviderConfig,
settingsConfig: SettingsConfig,
): Record<string, string> {
const settings: Record<string, string> = {
CLAUDE_MEM_WORKER_PORT: settingsConfig.workerPort,
CLAUDE_MEM_WORKER_HOST: '127.0.0.1',
CLAUDE_MEM_DATA_DIR: expandDataDir(settingsConfig.dataDir),
CLAUDE_MEM_CONTEXT_OBSERVATIONS: settingsConfig.contextObservations,
CLAUDE_MEM_LOG_LEVEL: settingsConfig.logLevel,
CLAUDE_MEM_PYTHON_VERSION: settingsConfig.pythonVersion,
CLAUDE_MEM_PROVIDER: providerConfig.provider,
};
// Provider-specific settings
if (providerConfig.provider === 'claude') {
settings.CLAUDE_MEM_CLAUDE_AUTH_METHOD = providerConfig.claudeAuthMethod ?? 'cli';
}
if (providerConfig.provider === 'gemini') {
if (providerConfig.apiKey) settings.CLAUDE_MEM_GEMINI_API_KEY = providerConfig.apiKey;
if (providerConfig.model) settings.CLAUDE_MEM_GEMINI_MODEL = providerConfig.model;
settings.CLAUDE_MEM_GEMINI_RATE_LIMITING_ENABLED = providerConfig.rateLimitingEnabled !== false ? 'true' : 'false';
}
if (providerConfig.provider === 'openrouter') {
if (providerConfig.apiKey) settings.CLAUDE_MEM_OPENROUTER_API_KEY = providerConfig.apiKey;
if (providerConfig.model) settings.CLAUDE_MEM_OPENROUTER_MODEL = providerConfig.model;
}
// Chroma settings
if (settingsConfig.chromaEnabled) {
settings.CLAUDE_MEM_CHROMA_MODE = settingsConfig.chromaMode ?? 'local';
if (settingsConfig.chromaMode === 'remote') {
if (settingsConfig.chromaHost) settings.CLAUDE_MEM_CHROMA_HOST = settingsConfig.chromaHost;
if (settingsConfig.chromaPort) settings.CLAUDE_MEM_CHROMA_PORT = settingsConfig.chromaPort;
if (settingsConfig.chromaSsl !== undefined) settings.CLAUDE_MEM_CHROMA_SSL = String(settingsConfig.chromaSsl);
}
}
return settings;
}
export function writeSettings(
providerConfig: ProviderConfig,
settingsConfig: SettingsConfig,
): void {
const dataDir = expandDataDir(settingsConfig.dataDir);
const settingsPath = join(dataDir, 'settings.json');
// Ensure data directory exists
if (!existsSync(dataDir)) {
mkdirSync(dataDir, { recursive: true });
}
// Merge with existing settings if upgrading
let existingSettings: Record<string, string> = {};
if (existsSync(settingsPath)) {
const raw = readFileSync(settingsPath, 'utf-8');
existingSettings = JSON.parse(raw);
}
const newSettings = buildSettingsObject(providerConfig, settingsConfig);
// Merge: new settings override existing ones
const merged = { ...existingSettings, ...newSettings };
writeFileSync(settingsPath, JSON.stringify(merged, null, 2) + '\n', 'utf-8');
}

View File

@@ -1,49 +0,0 @@
import { execSync } from 'child_process';
import { homedir } from 'os';
import { join } from 'path';
export type OSType = 'macos' | 'linux' | 'windows';
export function detectOS(): OSType {
switch (process.platform) {
case 'darwin': return 'macos';
case 'win32': return 'windows';
default: return 'linux';
}
}
export function commandExists(command: string): boolean {
try {
execSync(`which ${command}`, { stdio: 'pipe' });
return true;
} catch {
return false;
}
}
export interface CommandResult {
stdout: string;
stderr: string;
exitCode: number;
}
export function runCommand(command: string, args: string[] = []): CommandResult {
try {
const fullCommand = [command, ...args].join(' ');
const stdout = execSync(fullCommand, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
return { stdout: stdout.trim(), stderr: '', exitCode: 0 };
} catch (error: any) {
return {
stdout: error.stdout?.toString().trim() ?? '',
stderr: error.stderr?.toString().trim() ?? '',
exitCode: error.status ?? 1,
};
}
}
export function expandHome(filepath: string): string {
if (filepath.startsWith('~')) {
return join(homedir(), filepath.slice(1));
}
return filepath;
}

View File

@@ -1,17 +0,0 @@
{
"compilerOptions": {
"module": "ESNext",
"target": "ES2022",
"moduleResolution": "bundler",
"esModuleInterop": true,
"strict": true,
"outDir": "dist",
"rootDir": "src",
"declaration": false,
"skipLibCheck": true,
"resolveJsonModule": true,
"forceConsistentCasingInFileNames": true
},
"include": ["src/**/*.ts"],
"exclude": ["node_modules", "dist"]
}

View File

@@ -30,7 +30,7 @@ import {
import { detectInstalledIDEs } from './ide-detection.js';
// ---------------------------------------------------------------------------
// Registration helpers (mirror installer/src/steps/install.ts)
// Registration helpers
// ---------------------------------------------------------------------------
function registerMarketplace(): void {