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/ datasets/
node_modules/ node_modules/
dist/ dist/
!installer/dist/
**/_tree-sitter/ **/_tree-sitter/
*.log *.log
.DS_Store .DS_Store

View File

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

View File

@@ -127,7 +127,13 @@
## Quick Start ## 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 /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. 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 ### 🦞 OpenClaw Gateway

View File

@@ -7,24 +7,35 @@ description: "Install Claude-Mem plugin for persistent memory across sessions"
## Quick Start ## 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 ```bash
/plugin marketplace add thedotmack/claude-mem /plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem /plugin install claude-mem
``` ```
That's it! The plugin will automatically: 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.
- 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.
> **Important:** Claude-Mem is published on npm, but running `npm install -g claude-mem` installs the > **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. > **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 ## System Requirements

View File

@@ -11,7 +11,13 @@ Claude-Mem seamlessly preserves context across sessions by automatically capturi
## Quick Start ## 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 ```bash
/plugin marketplace add thedotmack/claude-mem /plugin marketplace add thedotmack/claude-mem

View File

@@ -1,59 +1,25 @@
#!/bin/bash #!/bin/bash
set -euo pipefail set -euo pipefail
# claude-mem installer bootstrap # claude-mem installer redirect
# Usage: curl -fsSL https://install.cmem.ai | bash # The old curl-pipe-bash installer has been replaced by npx claude-mem.
# or: curl -fsSL https://install.cmem.ai | bash -s -- --provider=gemini --api-key=YOUR_KEY # This script now redirects users to the new install method.
INSTALLER_URL="https://install.cmem.ai/installer.js"
# Colors # Colors
RED='\033[0;31m' RED='\033[0;31m'
GREEN='\033[0;32m' GREEN='\033[0;32m'
CYAN='\033[0;36m' CYAN='\033[0;36m'
YELLOW='\033[0;33m'
NC='\033[0m' # No Color NC='\033[0m' # No Color
error() { echo -e "${RED}Error: $1${NC}" >&2; exit 1; } echo ""
info() { echo -e "${CYAN}$1${NC}"; } echo -e "${YELLOW}The curl-pipe-bash installer has been replaced.${NC}"
echo ""
# Check Node.js echo -e "${GREEN}Install claude-mem with a single command:${NC}"
if ! command -v node &> /dev/null; then echo ""
error "Node.js is required but not found. Install from https://nodejs.org" echo -e " ${CYAN}npx claude-mem install${NC}"
fi echo ""
echo -e "This requires Node.js >= 18. Get it from ${CYAN}https://nodejs.org${NC}"
NODE_VERSION=$(node -v | sed 's/v//') echo ""
NODE_MAJOR=$(echo "$NODE_VERSION" | cut -d. -f1) echo -e "For more info, visit: ${CYAN}https://docs.claude-mem.ai/installation${NC}"
if [ "$NODE_MAJOR" -lt 18 ]; then echo ""
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

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'; import { detectInstalledIDEs } from './ide-detection.js';
// --------------------------------------------------------------------------- // ---------------------------------------------------------------------------
// Registration helpers (mirror installer/src/steps/install.ts) // Registration helpers
// --------------------------------------------------------------------------- // ---------------------------------------------------------------------------
function registerMarketplace(): void { function registerMarketplace(): void {