memoir-cli 3.2.2 → 3.3.0

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,26 @@
+---
+name: Bug report
+about: Something isn't working
+title: ''
+labels: bug
+assignees: ''
+---
+
+**What happened?**
+A clear description of the bug.
+
+**Steps to reproduce**
+1. Run `memoir ...`
+2. See error
+
+**Expected behavior**
+What you expected to happen.
+
+**Environment**
+- OS: [e.g. macOS 15, Windows 11, Ubuntu 24]
+- Node: [e.g. 20.11.0]
+- memoir version: [e.g. 3.2.2]
+- AI tools: [e.g. Claude Code, Cursor]
+
+**Logs / screenshots**
+Paste any error output here.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,16 @@
+---
+name: Feature request
+about: Suggest an idea for memoir
+title: ''
+labels: enhancement
+assignees: ''
+---
+
+**What would you like?**
+A clear description of the feature.
+
+**Why?**
+What problem does this solve for you?
+
+**Alternatives considered**
+Any workarounds you've tried.

package/CONTRIBUTING.md

@@ -0,0 +1,47 @@
+# Contributing to memoir
+
+Thanks for your interest in contributing! memoir is open source and welcomes contributions.
+
+## Quick start
+
+```bash
+git clone https://github.com/camgitt/memoir.git
+cd memoir
+npm install
+node bin/memoir.js status
+```
+
+## What to work on
+
+- **New tool adapters** — add support for more AI tools in `src/tools/`
+- **MCP improvements** — enhance the MCP server in `src/mcp.js`
+- **Bug fixes** — check [open issues](https://github.com/camgitt/memoir/issues)
+- **Documentation** — improve README, add examples
+
+## Submitting changes
+
+1. Fork the repo
+2. Create a branch (`git checkout -b feature/my-feature`)
+3. Make your changes
+4. Test locally: `npm test`
+5. Commit and push
+6. Open a PR with a clear description
+
+## Code style
+
+- ES modules (`import`/`export`)
+- No TypeScript (plain JS)
+- Keep dependencies minimal
+
+## Adding a tool adapter
+
+See `src/tools/claude.js` for an example. Each adapter exports:
+- `name` — display name
+- `icon` — emoji
+- `source` — path to the tool's config directory
+- `files` — specific files to sync (if `customExtract` is true)
+- `filter` — function to include/exclude files
+
+## Questions?
+
+Open an issue or start a discussion.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 camgitt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -6,14 +6,17 @@
 
 [![npm version](https://img.shields.io/npm/v/memoir-cli.svg?style=flat-square&color=7c6ef0)](https://npmjs.org/package/memoir-cli)
 [![npm downloads](https://img.shields.io/npm/dm/memoir-cli.svg?style=flat-square&color=7c6ef0)](https://npmjs.org/package/memoir-cli)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![GitHub stars](https://img.shields.io/github/stars/camgitt/memoir?style=flat-square&color=7c6ef0)](https://github.com/camgitt/memoir/stargazers)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square)](https://nodejs.org)
 
 Your AI forgets everything between sessions. memoir gives it long-term memory via MCP.
 
-Works with Claude Code, Cursor, Windsurf, Gemini, and 7 more tools.
+**11 tools supported** • **E2E encrypted** • **Cross-platform** • **Open source**
 
-[Website](https://memoir.sh) • [npm](https://npmjs.org/package/memoir-cli) • [Blog](https://memoir.sh/blog)
+Works with Claude Code, Cursor, Windsurf, Gemini, Copilot, Codex, ChatGPT, Aider, Zed, Cline, and Continue.dev.
+
+[Website](https://memoir.sh) • [npm](https://npmjs.org/package/memoir-cli) • [Blog](https://memoir.sh/blog) • [Contributing](CONTRIBUTING.md)
 
 <br />
 
@@ -44,6 +47,27 @@ claude: Based on your previous sessions: this project uses JWT auth
 
 No re-explaining. memoir remembered.
 
+## Architecture
+
+```mermaid
+graph LR
+    A[Claude Code] --> M[memoir MCP]
+    B[Cursor] --> M
+    C[Gemini CLI] --> M
+    D[Windsurf] --> M
+    E[+ 7 more] --> M
+
+    M --> R[recall / remember / list / read]
+    R --> S[(Local Memory Store)]
+
+    S --> P[memoir push]
+    P --> G[GitHub / Cloud]
+    G --> Q[memoir restore]
+    Q --> S2[(New Machine)]
+```
+
+memoir runs as a local MCP server inside your AI tools. Your AI can search, save, and recall memories automatically. Push to sync across machines.
+
 ## Quick Start
 
 ```bash

package/bin/memoir.js

@@ -14,7 +14,7 @@ import { migrateCommand } from '../src/commands/migrate.js';
 import { snapshotCommand } from '../src/commands/snapshot.js';
 import { resumeCommand } from '../src/commands/resume.js';
 import { profileListCommand, profileCreateCommand, profileSwitchCommand, profileDeleteCommand } from '../src/commands/profile.js';
-import { loginCommand, logoutCommand } from '../src/commands/login.js';
+import { loginCommand, logoutCommand, forgotPasswordCommand } from '../src/commands/login.js';
 import { cloudPushCommand, cloudRestoreCommand } from '../src/commands/cloud.js';
 import { shareCommand } from '../src/commands/share.js';
 import { historyCommand } from '../src/commands/history.js';
@@ -348,9 +348,12 @@ program
 program
   .command('login')
   .description('Sign in to memoir cloud')
-  .action(async () => {
+  .option('--email <email>', 'Email address (skip interactive prompt)')
+  .option('--password <password>', 'Password (skip interactive prompt)')
+  .option('--signup', 'Create a new account instead of signing in')
+  .action(async (options) => {
     try {
-      await loginCommand();
+      await loginCommand(options);
     } catch (err) {
       console.error(chalk.red('\n✖ Error:'), err.message);
       process.exit(1);
@@ -369,6 +372,20 @@ program
     }
   });
 
+program
+  .command('forgot-password')
+  .alias('reset-password')
+  .description('Send a password reset email')
+  .option('--email <email>', 'Email address (skip interactive prompt)')
+  .action(async (options) => {
+    try {
+      await forgotPasswordCommand(options);
+    } catch (err) {
+      console.error(chalk.red('\n✖ Error:'), err.message);
+      process.exit(1);
+    }
+  });
+
 // Cloud sync
 const cloud = program.command('cloud').description('Cloud backup and restore (Pro)');
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memoir-cli",
-  "version": "3.2.2",
+  "version": "3.3.0",
   "mcpName": "io.github.camgitt/memoir",
   "description": "Persistent memory for AI coding tools via MCP. Your AI remembers across sessions, tools, and machines. Works with Claude, Cursor, Gemini, Windsurf, and 7 more tools.",
   "main": "src/index.js",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/camgitt/memoir",
     "source": "github"
   },
-  "version": "3.2.0",
+  "version": "3.2.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "memoir-cli",
-      "version": "3.2.0",
+      "version": "3.2.2",
       "transport": {
         "type": "stdio"
       }

package/src/cloud/auth.js

@@ -25,7 +25,13 @@ async function supaFetch(endpoint, options = {}) {
 export async function signUp(email, password) {
   const res = await supaFetch('/auth/v1/signup', {
     method: 'POST',
-    body: JSON.stringify({ email, password }),
+    body: JSON.stringify({
+      email,
+      password,
+      options: {
+        emailRedirectTo: 'https://memoir.sh/confirmed',
+      },
+    }),
   });
   const data = await res.json();
   if (!res.ok) throw new Error(data.error_description || data.msg || 'Sign up failed');
@@ -109,4 +115,20 @@ export async function getSubscription(session) {
   return data[0];
 }
 
+export async function resetPassword(email) {
+  const res = await supaFetch('/auth/v1/recover', {
+    method: 'POST',
+    body: JSON.stringify({
+      email,
+      options: {
+        redirectTo: 'https://memoir.sh/reset-password',
+      },
+    }),
+  });
+  if (!res.ok) {
+    const data = await res.json();
+    throw new Error(data.error_description || data.msg || 'Password reset failed');
+  }
+}
+
 export { AUTH_FILE, supaFetch };

package/src/cloud/constants.js

@@ -1,5 +1,5 @@
-export const SUPABASE_URL = 'https://oqrkxytbahfwjhcbyzrx.supabase.co';
-export const SUPABASE_ANON_KEY = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Im9xcmt4eXRiYWhmd2poY2J5enJ4Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzMyMTQ4MzMsImV4cCI6MjA4ODc5MDgzM30.jOKOi73OJgIgi1zj0VOIQkGp0xqS3ee4gfCjpdqCnvM';
+export const SUPABASE_URL = process.env.MEMOIR_SUPABASE_URL || 'https://oqrkxytbahfwjhcbyzrx.supabase.co';
+export const SUPABASE_ANON_KEY = process.env.MEMOIR_SUPABASE_ANON_KEY || 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Im9xcmt4eXRiYWhmd2poY2J5enJ4Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzMyMTQ4MzMsImV4cCI6MjA4ODc5MDgzM30.jOKOi73OJgIgi1zj0VOIQkGp0xqS3ee4gfCjpdqCnvM';
 export const STORAGE_BUCKET = 'memoir-backups';
 export const MAX_BACKUPS_FREE = 3;
 export const MAX_BACKUPS_PRO = 50;

package/src/cloud/storage.js

@@ -5,6 +5,7 @@ import { createGzip, createGunzip } from 'zlib';
 import { pipeline } from 'stream/promises';
 import { Readable, Writable } from 'stream';
 import { SUPABASE_URL, SUPABASE_ANON_KEY, STORAGE_BUCKET, MAX_BACKUPS_FREE, MAX_BACKUPS_PRO } from './constants.js';
+import { encryptBuffer, decryptBuffer } from '../security/encryption.js';
 
 // Bundle a directory into a JSON manifest + gzip
 async function bundleDir(dir) {
@@ -64,10 +65,19 @@ async function unbundleToDir(gzipped, destDir) {
   return files.length;
 }
 
+// Derive a stable encryption passphrase from the user's identity
+// Uses only user_id (immutable) — NOT email, which can change
+function cloudPassphrase(session) {
+  return `memoir-cloud:${session.user.id}`;
+}
+
 // Upload backup to Supabase Storage + insert metadata
 export async function uploadBackup(stagingDir, session, toolResults) {
   const gzipped = await bundleDir(stagingDir);
 
+  // Encrypt before upload (AES-256-GCM, keyed to user identity)
+  const encrypted = await encryptBuffer(gzipped, cloudPassphrase(session));
+
   const backupId = crypto.randomUUID();
   const storagePath = `${session.user.id}/${backupId}.gz`;
 
@@ -79,7 +89,7 @@ export async function uploadBackup(stagingDir, session, toolResults) {
       'apikey': SUPABASE_ANON_KEY,
       'Content-Type': 'application/octet-stream',
     },
-    body: gzipped,
+    body: encrypted,
   });
 
   if (!uploadRes.ok) {
@@ -125,7 +135,7 @@ export async function uploadBackup(stagingDir, session, toolResults) {
       user_id: session.user.id,
       tool_count: tools.length,
       file_count: fileCount,
-      size_bytes: gzipped.length,
+      size_bytes: encrypted.length,
       tools,
       storage_path: storagePath,
       machine_name: os.hostname(),
@@ -139,7 +149,7 @@ export async function uploadBackup(stagingDir, session, toolResults) {
   }
 
   const backup = (await metaRes.json())[0];
-  return { ...backup, sizeBytes: gzipped.length };
+  return { ...backup, sizeBytes: encrypted.length };
 }
 
 // Download a specific backup
@@ -153,7 +163,17 @@ export async function downloadBackup(backup, destDir, session) {
 
   if (!res.ok) throw new Error(`Download failed: ${await res.text()}`);
 
-  const gzipped = Buffer.from(await res.arrayBuffer());
+  const raw = Buffer.from(await res.arrayBuffer());
+
+  // Decrypt if encrypted (check for MEMOIR01 magic header)
+  let gzipped;
+  if (raw.length >= 8 && raw.subarray(0, 8).toString() === 'MEMOIR01') {
+    gzipped = await decryptBuffer(raw, cloudPassphrase(session));
+  } else {
+    // Legacy unencrypted backup
+    gzipped = raw;
+  }
+
   const fileCount = await unbundleToDir(gzipped, destDir);
   return fileCount;
 }

package/src/commands/login.js

@@ -2,9 +2,9 @@ import chalk from 'chalk';
 import boxen from 'boxen';
 import gradient from 'gradient-string';
 import inquirer from 'inquirer';
-import { signIn, signUp, saveSession, getSession, logout, getSubscription } from '../cloud/auth.js';
+import { signIn, signUp, saveSession, getSession, logout, getSubscription, resetPassword } from '../cloud/auth.js';
 
-export async function loginCommand() {
+export async function loginCommand(options = {}) {
   // Check if already logged in
   const existing = await getSession();
   if (existing) {
@@ -18,32 +18,44 @@ export async function loginCommand() {
     return;
   }
 
-  console.log();
+  let action, email, password;
 
-  const { action } = await inquirer.prompt([{
-    type: 'list',
-    name: 'action',
-    message: 'Sign in or create account?',
-    choices: [
-      { name: 'Sign in (existing account)', value: 'signin' },
-      { name: 'Create account', value: 'signup' },
-    ],
-  }]);
+  // Support non-interactive login via flags
+  if (options.email && options.password) {
+    action = options.signup ? 'signup' : 'signin';
+    email = options.email;
+    password = options.password;
+  } else {
+    console.log();
 
-  const { email } = await inquirer.prompt([{
-    type: 'input',
-    name: 'email',
-    message: 'Email:',
-    validate: v => v.includes('@') ? true : 'Enter a valid email',
-  }]);
+    const actionAnswer = await inquirer.prompt([{
+      type: 'list',
+      name: 'action',
+      message: 'Sign in or create account?',
+      choices: [
+        { name: 'Sign in (existing account)', value: 'signin' },
+        { name: 'Create account', value: 'signup' },
+      ],
+    }]);
+    action = actionAnswer.action;
 
-  const { password } = await inquirer.prompt([{
-    type: 'password',
-    name: 'password',
-    message: 'Password:',
-    mask: '*',
-    validate: v => v.length >= 6 ? true : 'Password must be at least 6 characters',
-  }]);
+    const emailAnswer = await inquirer.prompt([{
+      type: 'input',
+      name: 'email',
+      message: 'Email:',
+      validate: v => v.includes('@') ? true : 'Enter a valid email',
+    }]);
+    email = emailAnswer.email;
+
+    const passwordAnswer = await inquirer.prompt([{
+      type: 'password',
+      name: 'password',
+      message: 'Password:',
+      mask: '*',
+      validate: v => v.length >= 6 ? true : 'Password must be at least 6 characters',
+    }]);
+    password = passwordAnswer.password;
+  }
 
   try {
     let session;
@@ -84,6 +96,34 @@ export async function loginCommand() {
   }
 }
 
+export async function forgotPasswordCommand(options = {}) {
+  let email = options.email;
+
+  if (!email) {
+    const emailAnswer = await inquirer.prompt([{
+      type: 'input',
+      name: 'email',
+      message: 'Email:',
+      validate: v => v.includes('@') ? true : 'Enter a valid email',
+    }]);
+    email = emailAnswer.email;
+  }
+
+  try {
+    await resetPassword(email);
+    console.log('\n' + boxen(
+      chalk.green('✔ Password reset email sent!') + '\n\n' +
+      chalk.white('Check ') + chalk.cyan(email) + chalk.white(' for a reset link.'),
+      { padding: 1, borderStyle: 'round', borderColor: 'green', dimBorder: true }
+    ) + '\n');
+  } catch (error) {
+    console.log('\n' + boxen(
+      chalk.red('✖ ' + error.message),
+      { padding: 1, borderStyle: 'round', borderColor: 'red' }
+    ) + '\n');
+  }
+}
+
 export async function logoutCommand() {
   await logout();
   console.log('\n' + boxen(

package/src/commands/upgrade.js

@@ -1,7 +1,30 @@
 import chalk from 'chalk';
 import boxen from 'boxen';
 import gradient from 'gradient-string';
-import { getSession, getSubscription } from '../cloud/auth.js';
+import ora from 'ora';
+import { getSession, getSubscription, supaFetch } from '../cloud/auth.js';
+import { SUPABASE_URL } from '../cloud/constants.js';
+
+async function createCheckoutSession(session) {
+  const res = await fetch(`${SUPABASE_URL}/functions/v1/stripe-checkout`, {
+    method: 'POST',
+    headers: {
+      'Authorization': `Bearer ${session.access_token}`,
+      'Content-Type': 'application/json',
+    },
+  });
+  const data = await res.json();
+  if (!res.ok) throw new Error(data.error || 'Failed to create checkout session');
+  return data.url;
+}
+
+function openUrl(url) {
+  const { exec } = require('child_process');
+  const platform = process.platform;
+  if (platform === 'darwin') exec(`open "${url}"`);
+  else if (platform === 'win32') exec(`start "" "${url}"`);
+  else exec(`xdg-open "${url}"`);
+}
 
 export async function upgradeCommand() {
   const session = await getSession();
@@ -23,7 +46,6 @@ export async function upgradeCommand() {
   const col2 = 22;
 
   const pad = (str, width) => {
-    // Strip ANSI for length calculation
     const stripped = str.replace(/\u001b\[[0-9;]*m/g, '');
     const diff = width - stripped.length;
     return diff > 0 ? str + ' '.repeat(diff) : str;
@@ -75,32 +97,32 @@ export async function upgradeCommand() {
     { padding: 1, borderStyle: 'round', borderColor: 'cyan', dimBorder: true }
   ));
 
-  // If free and logged in, open pricing page
+  // If free and logged in, open Stripe checkout
   if (session && currentPlan === 'free') {
-    console.log('\n' + chalk.cyan('  Opening pricing page...') + '\n');
-
-    const { exec } = await import('child_process');
-    const url = 'https://memoir.sh/pricing';
-
-    const platform = process.platform;
-    let cmd;
-    if (platform === 'darwin') {
-      cmd = `open "${url}"`;
-    } else if (platform === 'win32') {
-      cmd = `start "${url}"`;
-    } else {
-      cmd = `xdg-open "${url}"`;
-    }
+    const spinner = ora(chalk.cyan('  Creating checkout session...')).start();
 
-    exec(cmd, () => {});
-
-    console.log(
-      chalk.gray('  Once you\'ve completed payment, run ') +
-      chalk.cyan('memoir login') +
-      chalk.gray(' to refresh your plan.') + '\n'
-    );
+    try {
+      const url = await createCheckoutSession(session);
+      spinner.succeed(chalk.green('  Opening Stripe checkout...'));
+
+      const { exec } = await import('child_process');
+      const platform = process.platform;
+      if (platform === 'darwin') exec(`open "${url}"`);
+      else if (platform === 'win32') exec(`start "" "${url}"`);
+      else exec(`xdg-open "${url}"`);
+
+      console.log(
+        '\n' + chalk.gray('  Complete payment in your browser.') + '\n' +
+        chalk.gray('  Your plan updates automatically — run ') +
+        chalk.cyan('memoir upgrade') +
+        chalk.gray(' again to verify.') + '\n'
+      );
+    } catch (err) {
+      spinner.fail(chalk.red('  ' + err.message));
+      console.log(chalk.gray('\n  Fallback: visit ') + chalk.cyan('https://memoir.sh/pricing') + '\n');
+    }
   } else if (!session) {
-    console.log('\n' + chalk.gray('  Sign up at ') + chalk.cyan('memoir.sh/pricing') + chalk.gray(' or run ') + chalk.cyan('memoir login') + chalk.gray(' to get started.') + '\n');
+    console.log('\n' + chalk.gray('  Run ') + chalk.cyan('memoir login') + chalk.gray(' to create an account, then ') + chalk.cyan('memoir upgrade') + chalk.gray(' to subscribe.') + '\n');
   } else {
     console.log();
   }