memoir-cli 3.1.1 → 3.2.0

package/GAMEPLAN.md

@@ -0,0 +1,235 @@
+# Memoir Business Game Plan
+**Date:** March 25, 2026 | **Status:** Pre-revenue | **Author:** Boardroom consensus + CEO directive
+
+---
+
+## Current State
+
+| Metric | Value |
+|--------|-------|
+| Version | 3.1.2 (npm) |
+| Revenue | $0 |
+| Users | ~50 npm downloads |
+| AI Tools Supported | 11 (Claude, Gemini, Cursor, Copilot, Windsurf, Zed, Cline, Continue, Aider, Codex, ChatGPT) |
+| Cloud Backend | Supabase (auth + storage + PostgreSQL) |
+| Landing Page | memoir.sh (Vercel, 13 blog posts, no email capture) |
+| Blog Posts | 13 SEO-targeted articles |
+| Analytics | None (CLI or website) |
+| Payment Processing | None |
+| Team Features | None |
+| Shareable Links | None |
+
+---
+
+## What's Already Built (Don't Rebuild)
+
+- **CLI core** — push, restore, snapshot, resume, migrate, diff, profiles, doctor
+- **Cloud sync** — Supabase auth (email/password), gzipped bundles in Storage, PostgreSQL metadata
+- **Free/Pro tiers** — enforced in code (Free: 3 backups, Pro: 50) — but no way to pay for Pro
+- **Version history** — cloud backups versioned, restore from any version
+- **E2E encryption** — AES-256-GCM, async scrypt (just fixed), client-side before upload
+- **Workspace sync** — clones git repos, bundles non-git projects, applies uncommitted patches
+- **Session handoff** — snapshot current session, resume on another machine
+- **Landing page** — memoir.sh with animated terminal demo, tool marquee, FAQ, competitor comparison
+- **13 SEO blog posts** — sync guides for each tool, comparisons, setup guides
+
+---
+
+## The Plan: 4 Phases
+
+### Phase 1: Monetization Foundation (Week 1-2)
+> **Goal:** Accept money. Capture emails. Track usage.
+
+| Task | Priority | Effort | Details |
+|------|----------|--------|---------|
+| Add Stripe integration | P0 | 1 day | Connect to Pro tier ($15/mo individual, already priced in competitor comparison) |
+| `memoir upgrade` command | P0 | 0.5 day | Opens Stripe checkout from CLI, activates Pro |
+| Add pricing page to memoir.sh | P0 | 0.5 day | Free vs Pro vs Teams (coming soon) |
+| Add email capture / waitlist | P0 | 0.5 day | "Get notified for Teams" — collect emails on memoir.sh |
+| Add PostHog analytics to CLI | P1 | 0.5 day | Anonymous: commands used, tool count, machine OS, cloud vs local |
+| Add PostHog to memoir.sh | P1 | 0.5 day | Page views, blog reads, install clicks |
+| `memoir doctor` completion | P2 | 0.5 day | Finish the stubbed diagnostics command |
+
+**Phase 1 deliverable:** People can pay. We know who's using what.
+
+---
+
+### Phase 2: Viral Loop + Shareability (Week 3-4)
+> **Goal:** Every user brings one more user.
+
+| Task | Priority | Effort | Details |
+|------|----------|--------|---------|
+| Shareable context links | P0 | 2 days | `memoir share` → generates encrypted link (Supabase signed URL, 24hr expiry). Recipient runs `memoir restore --from <link>` |
+| Share landing page | P0 | 0.5 day | When link is opened in browser (not CLI), show "Install memoir to restore this context" with one-click copy |
+| Team invite flow | P1 | 1 day | `memoir team create`, `memoir team invite <email>` — shared backup namespace in Supabase |
+| Onboarding context | P1 | 0.5 day | `memoir push --share` generates a restore link printed to terminal. Copy-paste to Slack |
+| "Synced with memoir" badge | P2 | 0.5 day | Auto-append to CLAUDE.md / .cursorrules when synced — passive discovery |
+
+**Phase 2 deliverable:** Sharing is the viral loop. Every shared link = a new install prompt.
+
+---
+
+### Phase 3: Teams Tier (Week 5-8)
+> **Goal:** $29/seat/month revenue from dev teams.
+
+| Task | Priority | Effort | Details |
+|------|----------|--------|---------|
+| Organizations in Supabase | P0 | 2 days | `organizations` table, `org_members` table, role-based (admin/member) |
+| Shared team backups | P0 | 2 days | `memoir push --team` syncs to org namespace. All members can restore team context |
+| Team dashboard (web) | P1 | 3 days | memoir.sh/dashboard — see team members, backup history, storage usage |
+| Seat-based billing | P0 | 1 day | Stripe per-seat subscription, enforce in CLI |
+| Context inheritance | P1 | 1 day | `memoir restore --from <teammate>` — pull specific teammate's context with permission |
+| Audit log | P2 | 1 day | Who pushed, who restored, when — enterprise compliance checkbox |
+| SSO (Google/GitHub) | P2 | 1 day | Enterprise teams expect OAuth, not email/password |
+
+**Phase 3 deliverable:** Teams can buy seats, share context, see a dashboard.
+
+---
+
+### Phase 4: Enterprise + Moat (Week 9-12)
+> **Goal:** First $5k MRR. Lock-in through history depth.
+
+| Task | Priority | Effort | Details |
+|------|----------|--------|---------|
+| Context time-travel | P1 | 3 days | `memoir restore --version 5 --tool claude` — restore any tool to any point in history |
+| Diff between versions | P1 | 1 day | `memoir diff v3 v7` — show what changed in AI context between versions |
+| Context quality scoring | P2 | 2 days | Auto-tag backups: files changed, decisions made, session length. Surface "important" snapshots |
+| Enterprise pricing page | P1 | 0.5 day | $99/seat/month with SLA, priority support, SSO, audit logs |
+| SOC2 narrative | P2 | 1 day | Document E2E encryption, zero-knowledge architecture, audit trail for compliance conversations |
+| API for integrations | P2 | 3 days | REST API: programmatic backup/restore for CI/CD pipelines, onboarding scripts |
+
+**Phase 4 deliverable:** Enterprise-ready product with deep history moat.
+
+---
+
+## Pricing Structure
+
+| Tier | Price | Limits | Target |
+|------|-------|--------|--------|
+| **Free** | $0/forever | 3 cloud backups, local unlimited, 1 machine | Solo devs trying it out |
+| **Pro** | $15/month | 50 cloud backups, unlimited machines, version history | Power users, multi-machine devs |
+| **Teams** | $29/seat/month | Shared team context, dashboard, audit log, 200 backups/team | Dev teams (5-20 people) |
+| **Enterprise** | $99/seat/month | SSO, SLA, API access, compliance docs, unlimited backups | Companies (20+) |
+
+---
+
+## Positioning
+
+| Audience | Message |
+|----------|---------|
+| Individual dev | "Never lose your AI context again" |
+| Dev team lead | "Onboard devs in 60 seconds with full AI context" |
+| Enterprise buyer | "SOC2-ready AI workflow continuity" |
+| SEO / content | "Git for your AI setup" |
+
+**One-liner:** memoir syncs your AI memory across every machine and every teammate.
+
+**Anti-positioning (what we're NOT):** Not a dotfiles manager. Not VS Code Sync. Not a cloud IDE. We sync the AI layer — the conversations, decisions, and context that make your tools smart.
+
+---
+
+## First 100 Users Plan
+
+| Week | Action | Target |
+|------|--------|--------|
+| 1 | Ship Stripe + pricing page | Accept payments |
+| 2 | Post on r/programming, r/neovim, r/cursor, Hacker News | 500 page views |
+| 3 | Cold DM 50 developers who tweet about Claude/Cursor context loss | 10 installs |
+| 4 | Ship shareable links, post demo video on X/Twitter | 20 shares |
+| 5-6 | Reach out to 10 companies using Cursor (check their GitHub for .cursorrules) | 3 team pilots |
+| 7-8 | Ship Teams tier, convert pilots to paid | First $290 MRR |
+| 9-12 | Content marketing: "How Company X onboards devs in 60s" case study | 100 users, $1k+ MRR |
+
+---
+
+## Supabase Schema Changes Needed
+
+```sql
+-- Organizations
+CREATE TABLE organizations (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name TEXT NOT NULL,
+  slug TEXT UNIQUE NOT NULL,
+  owner_id UUID REFERENCES auth.users(id),
+  plan TEXT DEFAULT 'teams',
+  stripe_customer_id TEXT,
+  stripe_subscription_id TEXT,
+  created_at TIMESTAMPTZ DEFAULT now()
+);
+
+-- Org members
+CREATE TABLE org_members (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  org_id UUID REFERENCES organizations(id) ON DELETE CASCADE,
+  user_id UUID REFERENCES auth.users(id),
+  role TEXT DEFAULT 'member' CHECK (role IN ('admin', 'member')),
+  invited_by UUID REFERENCES auth.users(id),
+  joined_at TIMESTAMPTZ DEFAULT now(),
+  UNIQUE(org_id, user_id)
+);
+
+-- Shared links
+CREATE TABLE shared_links (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  backup_id UUID REFERENCES backups(id),
+  created_by UUID REFERENCES auth.users(id),
+  token TEXT UNIQUE NOT NULL,
+  expires_at TIMESTAMPTZ NOT NULL,
+  max_uses INT DEFAULT 1,
+  use_count INT DEFAULT 0,
+  created_at TIMESTAMPTZ DEFAULT now()
+);
+
+-- Add org_id to backups for team backups
+ALTER TABLE backups ADD COLUMN org_id UUID REFERENCES organizations(id);
+
+-- Add stripe fields to subscriptions
+ALTER TABLE subscriptions ADD COLUMN stripe_customer_id TEXT;
+ALTER TABLE subscriptions ADD COLUMN stripe_subscription_id TEXT;
+ALTER TABLE subscriptions ADD COLUMN seats INT DEFAULT 1;
+```
+
+---
+
+## New CLI Commands Summary
+
+```
+memoir upgrade          # Open Stripe checkout, activate Pro
+memoir share            # Generate encrypted shareable link
+memoir team create      # Create a team organization
+memoir team invite      # Invite teammate by email
+memoir team list        # List team members
+memoir push --team      # Push to team namespace
+memoir restore --from   # Restore from shared link or teammate
+memoir history --diff   # Diff between backup versions
+memoir analytics        # Show your usage stats (local)
+```
+
+---
+
+## Risk Register
+
+| Risk | Likelihood | Impact | Mitigation |
+|------|-----------|--------|------------|
+| AI tools change config paths | High | Medium | Version-gated path detection, community PRs for new tools |
+| Supabase costs spike with users | Medium | Medium | Gzip compression (already done), enforce tier limits, monitor |
+| Nobody pays for Pro | High | High | Validate with shareable links first (free viral), watch conversion |
+| Enterprise competitor (JetBrains, GitHub) builds this | Medium | High | Move fast, own the CLI mindshare, community moat |
+| ToS violations syncing AI configs | Low | High | Only sync user-owned files (configs, not conversations). Document clearly |
+| Data breach of cloud backups | Low | Critical | E2E encryption means we literally can't read user data. Zero-knowledge by design |
+
+---
+
+## This Week's Checklist
+
+- [ ] Stripe account setup + integration in CLI
+- [ ] `memoir upgrade` command
+- [ ] Pricing page on memoir.sh
+- [ ] Email capture for Teams waitlist on memoir.sh
+- [ ] PostHog analytics on CLI (anonymous, opt-out available)
+- [ ] PostHog analytics on memoir.sh
+- [ ] Post in 3 subreddits about memoir
+
+---
+
+*"The CLI is the funnel. Cloud is the product. Teams is the business."*

package/README.md

@@ -2,14 +2,14 @@
 
 # memoir
 
-**Your AI remembers everything. On every machine.**
+**AI tools forget you. memoir doesn't.**
 
 [![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)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square)](https://nodejs.org)
 
-Close your laptop. Open another one. **Your AI picks up exactly where you left off.**
+Sync memory across 11 AI tools. Search it all from your editor via MCP. One CLI, every device.
 
 [Website](https://memoir.sh) • [npm](https://npmjs.org/package/memoir-cli) • [Blog](https://memoir.sh/blog)
 
@@ -111,6 +111,35 @@ memoir push
 memoir restore
 ```
 
+## MCP Server (NEW in v3.2)
+
+memoir ships an MCP server so your AI tools can search, read, and save memories without leaving the conversation.
+
+```bash
+# Start the server
+memoir mcp
+```
+
+**Claude Code** — add to `~/.mcp.json`:
+```json
+{
+  "mcpServers": {
+    "memoir": { "command": "memoir-mcp" }
+  }
+}
+```
+
+**Cursor** — add to `.cursor/mcp.json`:
+```json
+{
+  "mcpServers": {
+    "memoir": { "command": "memoir-mcp" }
+  }
+}
+```
+
+Your editor gets 6 tools: `memoir_recall` (search all memories), `memoir_remember` (save context), `memoir_list`, `memoir_read`, `memoir_status`, and `memoir_profiles`. Zero cost — runs locally.
+
 ## Key Features
 
 ### Workspace sync
@@ -195,6 +224,7 @@ Claude's memory paths are automatically remapped between platforms. Projects are
 | `memoir cloud restore` | Restore from memoir cloud |
 | `memoir history` | View cloud backup versions |
 | `memoir login` | Sign in to memoir cloud |
+| `memoir mcp` | Start MCP server for editor integration |
 | `memoir update` | Self-update to latest version |
 
 ## How memoir compares
@@ -211,6 +241,7 @@ Claude's memory paths are automatically remapped between platforms. Projects are
 | Uncommitted work patches | **Yes** | No | No | No |
 | Cloud backup | **Yes** | No | No | Yes ($15/mo) |
 | Profiles | **Yes** | No | No | No |
+| MCP server | **Yes** | No | No | No |
 | Free & open source | **Yes** | Yes | Yes | No |
 
 ## Common Workflows

package/bin/memoir.js

@@ -16,7 +16,10 @@ 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 { cloudPushCommand, cloudRestoreCommand } from '../src/commands/cloud.js';
+import { shareCommand } from '../src/commands/share.js';
 import { historyCommand } from '../src/commands/history.js';
+import { projectsListCommand, projectsTodoCommand } from '../src/commands/projects.js';
+import { upgradeCommand } from '../src/commands/upgrade.js';
 import { createRequire } from 'module';
 
 const require = createRequire(import.meta.url);
@@ -62,12 +65,15 @@ if (process.argv.length <= 2) {
     chalk.cyan('  memoir resume    ') + chalk.gray('— pick up where you left off') + '\n' +
     chalk.cyan('  memoir status    ') + chalk.gray('— see detected AI tools') + '\n' +
     chalk.cyan('  memoir profile   ') + chalk.gray('— manage profiles (personal/work)') + '\n' +
+    chalk.cyan('  memoir projects   ') + chalk.gray('— see all your projects at a glance') + '\n' +
     chalk.cyan('  memoir encrypt   ') + chalk.gray('— toggle E2E encryption') + '\n' +
-    chalk.cyan('  memoir update    ') + chalk.gray('— update to latest version') + '\n\n' +
+    chalk.cyan('  memoir update    ') + chalk.gray('— update to latest version') + '\n' +
+    chalk.cyan('  memoir upgrade   ') + chalk.gray('— view plans & upgrade') + '\n\n' +
     chalk.white.bold('Cloud (Pro):') + '\n' +
     chalk.cyan('  memoir login         ') + chalk.gray('— sign in to memoir cloud') + '\n' +
     chalk.cyan('  memoir cloud push    ') + chalk.gray('— back up to the cloud') + '\n' +
     chalk.cyan('  memoir cloud restore ') + chalk.gray('— restore from cloud') + '\n' +
+    chalk.cyan('  memoir share         ') + chalk.gray('— share memory via secure link') + '\n' +
     chalk.cyan('  memoir history       ') + chalk.gray('— view backup versions') + '\n\n' +
     chalk.gray('  Tip: use --profile work to sync a specific profile') + '\n\n' +
     chalk.gray(`v${VERSION}`),
@@ -120,8 +126,9 @@ program
   .alias('pull')
   .description('Restore your AI memory on this machine')
   .option('--only <tools>', 'Only restore specific tools (comma-separated)')
-  .option('-y, --yes', 'Skip confirmation prompts (restore all)')
+  .option('-i, --interactive', 'Confirm each tool before restoring')
   .option('-p, --profile <name>', 'Use a specific profile')
+  .option('--from <token>', 'Restore from a share link token')
   .action(async (options) => {
     try {
       await restoreCommand(options);
@@ -131,6 +138,21 @@ program
     }
   });
 
+program
+  .command('share')
+  .description('Share your AI memory via a secure link')
+  .option('--only <tools>', 'Only share specific tools (comma-separated)')
+  .option('--expires <hours>', 'Link expiry in hours (default: 24)')
+  .option('--uses <number>', 'Max number of uses (default: 5)')
+  .action(async (options) => {
+    try {
+      await shareCommand(options);
+    } catch (err) {
+      console.error(chalk.red('\n✖ Error during share:'), err.message);
+      process.exit(1);
+    }
+  });
+
 program
   .command('status')
   .description('See what AI tools are on this machine')
@@ -219,7 +241,6 @@ program
 
 program
   .command('update')
-  .alias('upgrade')
   .description('Update memoir to the latest version')
   .action(async () => {
     try {
@@ -257,6 +278,19 @@ program
     }
   });
 
+program
+  .command('upgrade')
+  .alias('pro')
+  .description('View plans and upgrade your memoir subscription')
+  .action(async () => {
+    try {
+      await upgradeCommand();
+    } catch (err) {
+      console.error(chalk.red('\n✖ Error:'), err.message);
+      process.exit(1);
+    }
+  });
+
 program
   .command('encrypt')
   .description('Toggle E2E encryption for your backups')
@@ -432,6 +466,47 @@ profile
     }
   });
 
+// Project tracker
+const projects = program.command('projects').alias('p').description('Track and manage your projects');
+
+projects
+  .command('list', { isDefault: true })
+  .alias('ls')
+  .description('List all projects with recent activity')
+  .option('--all', 'Show all projects (default: top 15)')
+  .option('-v, --verbose', 'Show more commits and todos')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    try {
+      await projectsListCommand(options);
+    } catch (err) {
+      console.error(chalk.red('\n✖ Error:'), err.message);
+      process.exit(1);
+    }
+  });
+
+projects
+  .command('todo <project> [text]')
+  .description('Add or manage todos for a project')
+  .option('--done <index>', 'Mark a todo as done by number')
+  .option('--clear', 'Clear all todos for this project')
+  .action(async (project, text, options) => {
+    try {
+      await projectsTodoCommand(project, text, options);
+    } catch (err) {
+      console.error(chalk.red('\n✖ Error:'), err.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('mcp')
+  .description('Start the MCP server (for Claude Code, Cursor, VS Code integration)')
+  .action(async () => {
+    // Import and run the MCP server directly
+    await import('../src/mcp.js');
+  });
+
 program.hook('postAction', async () => {
   await checkForUpdate();
 });

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "memoir-cli",
-  "version": "3.1.1",
+  "version": "3.2.0",
   "description": "Sync AI memory across devices. Back up and restore Claude, Gemini, Codex, Cursor, Copilot, Windsurf configs. Snapshot coding sessions and resume on another machine. Migrate instructions between AI assistants.",
   "main": "src/index.js",
   "type": "module",
   "bin": {
-    "memoir": "bin/memoir.js"
+    "memoir": "bin/memoir.js",
+    "memoir-mcp": "src/mcp.js"
   },
   "repository": {
     "type": "git",
@@ -52,17 +53,21 @@
     "context-sync",
     "session-handoff",
     "snapshot",
-    "resume"
+    "resume",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol"
   ],
   "author": "camgitt",
   "license": "MIT",
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0",
     "boxen": "^7.1.1",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "fs-extra": "^11.2.0",
     "gradient-string": "^3.0.0",
     "inquirer": "^9.2.15",
-"ora": "^7.0.1"
+    "ora": "^7.0.1"
   }
 }