memoir-cli 3.1.0 → 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,43 +2,59 @@
 
 # memoir
 
-**Sync your AI memory across every device and every tool.**
+**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)
 
-Your AI tools forget you on every new machine. memoir fixes that.
+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)
 
 <br />
 
-![memoir demo](demo.gif)
-
 </div>
 
-## Why memoir
+## The Problem
 
-You spend weeks teaching your AI tools how you code. Your CLAUDE.md is dialed in. Your .cursorrules are perfect. Your ChatGPT custom instructions know your stack.
+You spend weeks teaching Claude how you code. Your projects are dialed in. Your AI knows your stack, your decisions, your preferences.
 
-Then you get a new laptop. **Everything is gone.**
+Then you switch machines. **Everything is gone.** Your AI has amnesia. Your projects aren't there. You start from zero.
 
-memoir backs up, restores, and **translates** your AI memory across any machine and any tool. One command to save. One command to restore.
+## The Fix
 
 ```bash
+# On your main machine
+memoir push
+
+# On any other machine
 npm install -g memoir-cli
+memoir restore -y
+
+# Done. Everything's back:
+# ✔ AI memory restored (Claude, Gemini, Cursor, 11 tools)
+# ✔ 44 projects cloned & unpacked
+# ✔ Uncommitted changes applied
+# ✔ Session context injected — AI picks up mid-conversation
 ```
 
-## Supported Tools (11)
+One command to save. One command to restore. That's it.
+
+## What Gets Synced
+
+memoir syncs three layers that no other tool connects:
+
+### Layer 1: AI Memory
+Your AI tool configs, preferences, and project knowledge across 11 tools.
 
 | Tool | What gets synced |
 |------|-----------------|
-| **ChatGPT** | CHATGPT.md custom instructions |
 | **Claude Code** | ~/.claude/ settings, memory, CLAUDE.md files |
 | **Gemini CLI** | ~/.gemini/ config, GEMINI.md files |
-| **OpenAI Codex** | ~/.codex/ config, AGENTS.md, codex.md |
+| **ChatGPT** | CHATGPT.md custom instructions |
+| **OpenAI Codex** | ~/.codex/ config, AGENTS.md |
 | **Cursor** | Settings, keybindings, .cursorrules |
 | **GitHub Copilot** | Config, copilot-instructions.md |
 | **Windsurf** | Settings, keybindings, .windsurfrules |
@@ -47,7 +63,37 @@ npm install -g memoir-cli
 | **Continue.dev** | Config, .continuerules |
 | **Aider** | .aider.conf.yml, system prompt |
 
-Plus **per-project configs** — memoir scans your filesystem for CLAUDE.md, GEMINI.md, CHATGPT.md, .cursorrules, and AGENTS.md across all your projects.
+### Layer 2: Session State
+What you were **doing** — not just what your AI knows, but the active context.
+
+- Last coding session captured automatically
+- What files you changed, what errors you hit, what decisions you made
+- Injected into your AI on restore so it picks up mid-conversation
+- Secrets auto-redacted (API keys, tokens, passwords stripped before sync)
+
+### Layer 3: Workspace (NEW in v3.1)
+Your actual projects — code, files, everything.
+
+- **Git projects:** Remote URLs saved, auto-cloned on restore
+- **Non-git projects:** Bundled as compressed archives, unpacked on restore
+- **Uncommitted work:** Saved as patches, applied after clone
+- **Zero git commands needed** — memoir handles it all
+
+```
+memoir push on Mac:
+  ✔ AI memory backed up
+  ✔ Session context captured
+  ✔ Workspace: 44 projects (17 git, 23 bundled)
+  🔒 E2E encrypted
+
+memoir restore on Windows:
+  ✔ AI memory restored
+  ✔ stock-market-book → C:\Users\You\stock-market-book (cloned)
+  ✔ socialslink → C:\Users\You\socialslink (cloned)
+  ✔ btc-trader → C:\Users\You\btc-trader (unpacked)
+  ✔ 41 more projects restored
+  📋 Session context injected — Claude picks up where you left off
+```
 
 ## Quick Start
 
@@ -55,41 +101,81 @@ Plus **per-project configs** — memoir scans your filesystem for CLAUDE.md, GEM
 # Install
 npm install -g memoir-cli
 
-# First-time setup (GitHub repo or local)
+# First-time setup
 memoir init
 
-# Back up all your AI configs
+# Back up everything
 memoir push
 
-# Restore on a new machine
+# Restore on any machine
 memoir restore
 ```
 
-That's it. Every AI tool gets its memory back.
+## 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
 
-### Translate between AI tools
+### Workspace sync
 ```bash
-memoir migrate --from chatgpt --to claude
-# AI-powered — rewrites conventions, not copy-paste
+memoir push     # scans all projects, saves git URLs + bundles non-git projects
+memoir restore  # auto-clones repos, unpacks bundles, applies uncommitted patches
 ```
 
-Works between any combination: ChatGPT, Claude, Gemini, Cursor, Copilot, Codex, Windsurf, Aider, and more. Translate to one tool or all at once:
+No manual git commands. memoir detects your projects, tracks their remotes, and restores them anywhere.
 
+### Translate between AI tools
 ```bash
+memoir migrate --from chatgpt --to claude
+# AI-powered — rewrites conventions, not copy-paste
+
 memoir migrate --from chatgpt --to all
+# Translate to every tool at once
 ```
 
 ### Session handoff
 ```bash
-# Laptop dying? Capture your session
+# Capture your session (automatic on push, or manual)
 memoir snapshot
 
 # Pick up on another machine
 memoir resume --inject --to claude
 ```
 
+### E2E Encryption
+```bash
+memoir encrypt    # toggle encryption on/off
+memoir push       # prompted for passphrase, AES-256-GCM encrypted
+```
+
+Your backup is encrypted before it leaves your machine. Even if your storage is compromised, your data is safe. Secret scanning auto-redacts API keys, tokens, and passwords.
+
 ### Profiles (personal / work)
 ```bash
 memoir profile create work
@@ -107,23 +193,24 @@ memoir cloud restore   # restore from any version
 memoir history         # view all backup versions
 ```
 
-Free tier: 3 cloud backups. Pro ($5/mo): unlimited + version history.
-
-### Security
+### Cross-platform (Mac / Windows / Linux)
 ```bash
-memoir doctor
-# Scans for secrets, API keys, .env files before pushing
+# Push from Mac
+memoir push
+
+# Restore on Windows — paths remap automatically
+memoir restore
 ```
 
-memoir **never** syncs credentials, API keys, .env files, or auth tokens.
+Claude's memory paths are automatically remapped between platforms. Projects are cloned to the right locations. It just works.
 
 ## All Commands
 
 | Command | What it does |
 |---------|-------------|
 | `memoir init` | Setup wizard — GitHub or local storage |
-| `memoir push` | Back up all AI configs |
-| `memoir restore` | Restore on a new machine |
+| `memoir push` | Back up AI memory + workspace + session |
+| `memoir restore` | Restore everything on a new machine |
 | `memoir status` | Show detected AI tools |
 | `memoir doctor` | Diagnose issues, scan for secrets |
 | `memoir view` | Preview what's in your backup |
@@ -131,66 +218,77 @@ memoir **never** syncs credentials, API keys, .env files, or auth tokens.
 | `memoir migrate` | Translate memory between tools via AI |
 | `memoir snapshot` | Capture current coding session |
 | `memoir resume` | Pick up where you left off |
+| `memoir encrypt` | Toggle E2E encryption |
 | `memoir profile` | Manage profiles (personal/work) |
 | `memoir cloud push` | Back up to memoir cloud |
 | `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
 
-| Feature | memoir | skillshare | ai-rulez | memories.sh |
-|---------|--------|-----------|----------|-------------|
-| Cross-device sync | **Yes** | Yes (git) | No | Yes |
+| Feature | memoir | dotfiles managers | ai-rulez | memories.sh |
+|---------|--------|-------------------|----------|-------------|
+| AI memory sync | **11 tools** | No | 18 tools | 3 tools |
+| Workspace sync | **Yes** | No | No | No |
+| Session handoff | **Yes** | No | No | No |
 | AI-powered translation | **Yes** | No | No | No |
-| Tools supported | **11** | 40+ | 18 | 3 |
+| E2E encryption | **Yes** | No | No | No |
+| Secret scanning | **Yes** | Some | No | No |
+| Cross-platform remap | **Yes** | Some | No | No |
+| Uncommitted work patches | **Yes** | No | No | No |
 | Cloud backup | **Yes** | No | No | Yes ($15/mo) |
-| Version history | **Yes** | No | No | No |
-| Session handoff | **Yes** | No | No | No |
 | Profiles | **Yes** | No | No | No |
-| Secret scanning | **Yes** | Yes | No | No |
+| MCP server | **Yes** | No | No | No |
 | Free & open source | **Yes** | Yes | Yes | No |
 
-memoir is free and open source. Cloud sync starts at $0 (3 backups free).
-
 ## Common Workflows
 
-### New laptop setup
+### New machine setup
 ```bash
 # Old machine
 memoir push
 
-# New machine
-npm install -g memoir-cli
-memoir init      # connect to same repo
-memoir restore   # all configs restored in seconds
+# New machine — one command, everything's back
+npm install -g memoir-cli && memoir init && memoir restore -y
 ```
 
-### Switching from ChatGPT to Claude
+### Daily sync between machines
 ```bash
-memoir migrate --from chatgpt --to claude
-# Your custom instructions become a proper CLAUDE.md
+memoir push      # end of day on laptop
+memoir restore   # next morning on desktop — AI knows what you were doing
 ```
 
-### Daily sync between machines
+### Switching AI tools
 ```bash
-memoir push      # end of day on laptop
-memoir restore   # next morning on desktop
+memoir migrate --from chatgpt --to claude
+# Your custom instructions become a proper CLAUDE.md
 ```
 
-### Cross-platform (Mac ↔ Windows ↔ Linux)
+### Team onboarding
 ```bash
-# Push from Mac
-memoir push
+# Senior dev pushes team config
+memoir push --profile team
 
-# Restore on Windows — paths remap automatically
-memoir restore
+# New hire runs one command
+memoir restore --profile team
+# Every project cloned. Every AI tool configured. Day one productive.
 ```
 
+## Security
+
+- **E2E encryption** — AES-256-GCM with scrypt key derivation
+- **Secret scanning** — 20+ patterns detect API keys, tokens, passwords, connection strings
+- **Auto-redaction** — secrets stripped from session handoffs before sync
+- **No credentials synced** — .env files, auth tokens, and API keys are never included
+- **Passphrase verified** — wrong passphrase caught before decrypt attempt
+
 ## Requirements
 
 - Node.js >= 18
+- Git (for workspace sync)
 - Works on macOS, Windows, Linux
 
 ## Contributing