@trlc/super-memory 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The Red Lobster Cartel
+
+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

@@ -0,0 +1,78 @@
+# 🦞 Super Memory CLI
+
+**Never forget a conversation again.**
+
+AI-powered persistent memory with cloud sync. Works with OpenClaw and any LLM workflow.
+
+## Installation
+
+```bash
+npm install -g @redlobstercartel/super-memory
+```
+
+## Quick Start
+
+```bash
+# Initialize with your license key
+super-memory init --license=XXXX-XXXX-XXXX-XXXX
+
+# Save a memory
+super-memory save "Fixed CORS by adding proxy middleware" --category=problem
+
+# Search your memories
+super-memory search "cors error"
+
+# Sync across devices
+super-memory sync
+
+# Check status
+super-memory status
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `init` | Initialize with license key |
+| `save` | Save a memory to cloud |
+| `search` | Search memories semantically |
+| `sync` | Sync with cloud storage |
+| `status` | Show license and stats |
+
+## Categories
+
+| Category | Emoji | Use For |
+|----------|-------|---------|
+| `gotcha` | 🔴 | Traps, pitfalls to avoid |
+| `problem` | 🟡 | Problems and their fixes |
+| `decision` | 🟤 | Important decisions made |
+| `discovery` | 🟣 | New learnings, insights |
+
+## Pricing
+
+| Plan | Price |
+|------|-------|
+| Monthly | $19/month |
+| Lifetime | $190 one-time |
+
+Both plans include unlimited memories and cloud sync.
+
+## OpenClaw Integration
+
+Super Memory is designed to work with OpenClaw. After installing, you can use:
+
+```
+@super-memory save "your memory" --category=discovery
+@super-memory search "query"
+@super-memory sync
+```
+
+## Links
+
+- 🌐 Website: https://theredlobstercartel.com/super-memory
+- 📧 Support: support@theredlobstercartel.com
+- 🐦 Twitter: @RedLobsterCartel
+
+---
+
+*🦞 The Red Lobster Cartel - Never forget a conversation again.*

package/dist/index.js

@@ -0,0 +1,450 @@
+#!/usr/bin/env node
+/**
+ * Super Memory CLI
+ * The Red Lobster Cartel 🦞
+ *
+ * Commands:
+ *   super-memory init --license=XXXX-XXXX-XXXX-XXXX
+ *   super-memory save "Your memory content" --category=discovery
+ *   super-memory search "query term"
+ *   super-memory sync
+ *   super-memory status
+ */
+import { execSync } from 'child_process';
+import { existsSync, mkdirSync, writeFileSync, readFileSync, appendFileSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import readline from 'readline';
+const CONVEX_URL = 'https://clear-lemming-473.convex.cloud';
+const VERSION = '1.0.0';
+// Paths
+const getBaseDir = () => join(homedir(), '.openclaw', 'workspace');
+const getMemoryDir = () => join(getBaseDir(), 'memory');
+const getConfigDir = () => join(getBaseDir(), '.super-memory');
+const getConfigPath = () => join(getConfigDir(), 'config.json');
+// Load config
+function loadConfig() {
+    const configPath = getConfigPath();
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    try {
+        return JSON.parse(readFileSync(configPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+// Save config
+function saveConfig(config) {
+    const configDir = getConfigDir();
+    if (!existsSync(configDir)) {
+        mkdirSync(configDir, { recursive: true });
+    }
+    writeFileSync(getConfigPath(), JSON.stringify(config, null, 2));
+}
+// Generate device ID
+function generateDeviceId() {
+    try {
+        const hostname = execSync('hostname', { encoding: 'utf-8' }).trim();
+        const user = execSync('whoami', { encoding: 'utf-8' }).trim();
+        return Buffer.from(`${hostname}-${user}`).toString('base64').slice(0, 16);
+    }
+    catch {
+        return 'unknown-device';
+    }
+}
+// Validate license key format
+function isValidLicenseKey(key) {
+    return /^[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$/.test(key);
+}
+// Convex API call
+async function convexCall(functionName, args) {
+    const response = await fetch(`${CONVEX_URL}/api/mutation`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            path: functionName,
+            args: args,
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`API call failed: ${response.status}`);
+    }
+    const result = await response.json();
+    if (result.status === 'error') {
+        throw new Error(result.errorMessage || 'Unknown error');
+    }
+    return result.value;
+}
+// Convex query call
+async function convexQuery(functionName, args) {
+    const response = await fetch(`${CONVEX_URL}/api/query`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            path: functionName,
+            args: args,
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`API call failed: ${response.status}`);
+    }
+    const result = await response.json();
+    if (result.status === 'error') {
+        throw new Error(result.errorMessage || 'Unknown error');
+    }
+    return result.value;
+}
+// COMMAND: init
+async function cmdInit(args) {
+    console.log(`
+🦞 ============================================
+   SUPER MEMORY by The Red Lobster Cartel
+   Never forget a conversation again
+   ============================================
+`);
+    // Get license key
+    let licenseKey = args.find(arg => arg.startsWith('--license='))?.split('=')[1];
+    if (!licenseKey) {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout
+        });
+        licenseKey = await new Promise((resolve) => {
+            rl.question('📝 Enter your license key (XXXX-XXXX-XXXX-XXXX): ', (answer) => {
+                rl.close();
+                resolve(answer.trim().toUpperCase());
+            });
+        });
+    }
+    if (!isValidLicenseKey(licenseKey)) {
+        console.error('❌ Invalid license key format');
+        process.exit(1);
+    }
+    console.log('\n🔍 Validating license...');
+    const deviceId = generateDeviceId();
+    try {
+        const validation = await convexCall('license:validate', {
+            licenseKey,
+            deviceId,
+            deviceName: `${process.platform}-${process.arch}`,
+            ipAddress: 'cli',
+        });
+        if (!validation.valid) {
+            console.error(`❌ License validation failed: ${validation.error}`);
+            process.exit(1);
+        }
+        console.log(`✅ License valid!`);
+        console.log(`📦 Plan: ${validation.plan === 'monthly' ? 'Monthly ($19/month)' : 'Lifetime ($190 one-time)'}`);
+        if (validation.expiresAt) {
+            console.log(`⏰ Expires: ${new Date(validation.expiresAt).toLocaleDateString()}`);
+        }
+        // Setup directories
+        console.log('\n📁 Setting up directories...');
+        const memoryDir = getMemoryDir();
+        const configDir = getConfigDir();
+        if (!existsSync(memoryDir)) {
+            mkdirSync(memoryDir, { recursive: true });
+        }
+        if (!existsSync(configDir)) {
+            mkdirSync(configDir, { recursive: true });
+        }
+        // Save config
+        const config = {
+            licenseKey,
+            deviceId,
+            plan: validation.plan,
+            installedAt: new Date().toISOString(),
+            version: VERSION,
+            lastSyncVersion: 0,
+        };
+        saveConfig(config);
+        // Create initial files
+        const today = new Date().toISOString().split('T')[0];
+        const indexPath = join(memoryDir, 'MEMORY_INDEX.md');
+        if (!existsSync(indexPath)) {
+            writeFileSync(indexPath, `# 🧠 MEMORY INDEX - Super Memory
+
+**Installed:** ${today}
+**Plan:** ${validation.plan}
+
+---
+
+## 🔴 Gotchas
+
+| # | Title | Date |
+|---|-------|------|
+
+## 🟡 Problem-Fix
+
+| # | Title | Date |
+|---|-------|------|
+
+## 🟤 Decisions
+
+| # | Title | Date |
+|---|-------|------|
+
+## 🟣 Discoveries
+
+| # | Title | Date |
+|---|-------|------|
+
+---
+
+*Powered by The Red Lobster Cartel 🦞*
+`);
+        }
+        console.log(`
+🎉 ============================================
+   INSTALLATION COMPLETE!
+   ============================================
+
+✅ License: ${licenseKey}
+✅ Plan: ${validation.plan}
+✅ Directory: ${memoryDir}
+
+🚀 Commands:
+   super-memory save "memory" --category=discovery
+   super-memory search "query"
+   super-memory sync
+   super-memory status
+
+🦞 Welcome to The Red Lobster Cartel!
+`);
+    }
+    catch (error) {
+        console.error(`❌ Error: ${error.message}`);
+        process.exit(1);
+    }
+}
+// COMMAND: save
+async function cmdSave(args) {
+    const config = loadConfig();
+    if (!config) {
+        console.error('❌ Not initialized. Run: super-memory init --license=YOUR_KEY');
+        process.exit(1);
+    }
+    // Parse content and category
+    const content = args.find(arg => !arg.startsWith('--'));
+    const categoryArg = args.find(arg => arg.startsWith('--category='))?.split('=')[1];
+    const category = categoryArg || 'discovery';
+    if (!content) {
+        console.error('❌ Usage: super-memory save "Your memory content" --category=discovery');
+        process.exit(1);
+    }
+    const validCategories = ['gotcha', 'problem', 'decision', 'discovery'];
+    if (!validCategories.includes(category)) {
+        console.error(`❌ Invalid category. Use: ${validCategories.join(', ')}`);
+        process.exit(1);
+    }
+    console.log('💾 Saving memory...');
+    // Save locally first
+    const memoryDir = getMemoryDir();
+    const today = new Date().toISOString().split('T')[0];
+    const dailyPath = join(memoryDir, `${today}.md`);
+    const emoji = { gotcha: '🔴', problem: '🟡', decision: '🟤', discovery: '🟣' };
+    const entry = `\n${emoji[category]} [${category.toUpperCase()}] ${content}\n`;
+    if (existsSync(dailyPath)) {
+        appendFileSync(dailyPath, entry);
+    }
+    else {
+        writeFileSync(dailyPath, `# Memory Log - ${today}\n${entry}`);
+    }
+    console.log('✅ Saved locally');
+    // Sync to cloud
+    try {
+        const result = await convexCall('sync:push', {
+            licenseKey: config.licenseKey,
+            deviceId: config.deviceId,
+            memories: [{
+                    content,
+                    category,
+                    layer: 3,
+                    source: `${today}.md`,
+                }],
+        });
+        if (result.success) {
+            config.lastSyncVersion = result.newVersion;
+            saveConfig(config);
+            console.log(`☁️  Synced to cloud (v${result.newVersion})`);
+        }
+    }
+    catch (error) {
+        console.warn(`⚠️  Cloud sync failed: ${error.message}`);
+    }
+    console.log(`\n${emoji[category]} Memory saved: "${content.substring(0, 50)}${content.length > 50 ? '...' : ''}"`);
+}
+// COMMAND: search
+async function cmdSearch(args) {
+    const config = loadConfig();
+    if (!config) {
+        console.error('❌ Not initialized. Run: super-memory init --license=YOUR_KEY');
+        process.exit(1);
+    }
+    const query = args.find(arg => !arg.startsWith('--'));
+    if (!query) {
+        console.error('❌ Usage: super-memory search "your query"');
+        process.exit(1);
+    }
+    console.log(`🔍 Searching for: "${query}"\n`);
+    try {
+        const results = await convexQuery('sync:search', {
+            licenseKey: config.licenseKey,
+            query,
+            limit: 10,
+        });
+        if (results.length === 0) {
+            console.log('No matches found.');
+            return;
+        }
+        const emoji = { gotcha: '🔴', problem: '🟡', decision: '🟤', discovery: '🟣' };
+        console.log(`Found ${results.length} memories:\n`);
+        for (const r of results) {
+            console.log(`${emoji[r.category] || '📝'} [${r.similarity}%] ${r.content.substring(0, 100)}${r.content.length > 100 ? '...' : ''}`);
+            console.log(`   Source: ${r.source} | ${new Date(r.createdAt).toLocaleDateString()}\n`);
+        }
+    }
+    catch (error) {
+        console.error(`❌ Search failed: ${error.message}`);
+    }
+}
+// COMMAND: sync
+async function cmdSync(args) {
+    const config = loadConfig();
+    if (!config) {
+        console.error('❌ Not initialized. Run: super-memory init --license=YOUR_KEY');
+        process.exit(1);
+    }
+    console.log('🔄 Syncing with cloud...\n');
+    try {
+        const result = await convexCall('sync:pull', {
+            licenseKey: config.licenseKey,
+            deviceId: config.deviceId,
+            lastSyncVersion: config.lastSyncVersion,
+        });
+        console.log(`📥 Pulled ${result.memories.length} new memories`);
+        console.log(`📊 Current version: ${result.latestVersion}`);
+        config.lastSyncVersion = result.latestVersion;
+        saveConfig(config);
+        console.log('\n✅ Sync complete!');
+    }
+    catch (error) {
+        console.error(`❌ Sync failed: ${error.message}`);
+    }
+}
+// COMMAND: status
+async function cmdStatus(args) {
+    const config = loadConfig();
+    if (!config) {
+        console.error('❌ Not initialized. Run: super-memory init --license=YOUR_KEY');
+        process.exit(1);
+    }
+    console.log(`
+🦞 Super Memory Status
+======================
+`);
+    console.log(`📋 License: ${config.licenseKey}`);
+    console.log(`📦 Plan: ${config.plan}`);
+    console.log(`🖥️  Device: ${config.deviceId}`);
+    console.log(`📅 Installed: ${config.installedAt}`);
+    console.log(`🔢 Version: ${config.version}`);
+    console.log(`📊 Last Sync Version: ${config.lastSyncVersion}`);
+    try {
+        const stats = await convexQuery('license:getStats', {
+            licenseKey: config.licenseKey,
+        });
+        console.log(`\n☁️  Cloud Stats:`);
+        console.log(`   Total Memories: ${stats.totalMemories}`);
+        console.log(`   🔴 Gotchas: ${stats.memoriesByCategory.gotcha}`);
+        console.log(`   🟡 Problems: ${stats.memoriesByCategory.problem}`);
+        console.log(`   🟤 Decisions: ${stats.memoriesByCategory.decision}`);
+        console.log(`   🟣 Discoveries: ${stats.memoriesByCategory.discovery}`);
+        console.log(`   Devices: ${stats.totalDevices}`);
+        if (stats.lastSyncAt) {
+            console.log(`   Last Sync: ${new Date(stats.lastSyncAt).toLocaleString()}`);
+        }
+    }
+    catch (error) {
+        console.warn(`\n⚠️  Could not fetch cloud stats: ${error.message}`);
+    }
+}
+// COMMAND: help
+function cmdHelp() {
+    console.log(`
+🦞 Super Memory CLI v${VERSION}
+   The Red Lobster Cartel
+
+COMMANDS:
+  init                         Initialize with license key
+    --license=XXXX-XXXX-XXXX-XXXX
+
+  save <content>               Save a memory
+    --category=gotcha|problem|decision|discovery
+
+  search <query>               Search memories
+    --limit=10
+
+  sync                         Sync with cloud
+
+  status                       Show status and stats
+
+  help                         Show this help
+
+EXAMPLES:
+  super-memory init --license=ABCD-1234-EFGH-5678
+  super-memory save "Fixed CORS with proxy config" --category=problem
+  super-memory search "cors error"
+  super-memory sync
+  super-memory status
+
+WEBSITE: https://theredlobstercartel.com/super-memory
+SUPPORT: support@theredlobstercartel.com
+`);
+}
+// Main
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0]?.toLowerCase();
+    const cmdArgs = args.slice(1);
+    switch (command) {
+        case 'init':
+            await cmdInit(cmdArgs);
+            break;
+        case 'save':
+            await cmdSave(cmdArgs);
+            break;
+        case 'search':
+            await cmdSearch(cmdArgs);
+            break;
+        case 'sync':
+            await cmdSync(cmdArgs);
+            break;
+        case 'status':
+            await cmdStatus(cmdArgs);
+            break;
+        case 'help':
+        case '--help':
+        case '-h':
+            cmdHelp();
+            break;
+        case '--version':
+        case '-v':
+            console.log(`Super Memory CLI v${VERSION}`);
+            break;
+        default:
+            if (!command) {
+                cmdHelp();
+            }
+            else {
+                console.error(`Unknown command: ${command}`);
+                console.log('Run "super-memory help" for usage.');
+                process.exit(1);
+            }
+    }
+}
+main().catch((error) => {
+    console.error(`Fatal error: ${error.message}`);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@trlc/super-memory",
+  "version": "1.0.0",
+  "description": "Super Memory CLI - AI-powered persistent memory by The Red Lobster Cartel",
+  "main": "dist/index.js",
+  "bin": {
+    "super-memory": "dist/index.js"
+  },
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "node dist/index.js --help"
+  },
+  "keywords": [
+    "ai",
+    "memory",
+    "openclaw",
+    "persistent",
+    "context",
+    "llm",
+    "agent"
+  ],
+  "author": "The Red Lobster Cartel",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/theredlobstercartel/super-memory-saas.git",
+    "directory": "cli"
+  },
+  "homepage": "https://theredlobstercartel.com/super-memory",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "convex": "^1.17.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  }
+}