memoire-ai 0.1.9 → 0.2.1

package/dist/cli.js

@@ -26,12 +26,24 @@ const { values, positionals } = parseArgs({
         'user-email': { type: 'string' },
         'setup-token': { type: 'string' },
         'invite-token': { type: 'string' },
+        'invite-code': { type: 'string' },
         'config-path': { type: 'string' },
         'client-id': { type: 'string' },
         port: { type: 'string' },
         'allow-origin': { type: 'string' },
         json: { type: 'boolean' },
         help: { type: 'boolean', short: 'h' },
+        // Wizard-specific flags
+        'non-interactive': { type: 'boolean' },
+        'skip-start': { type: 'boolean' },
+        cloud: { type: 'boolean' },
+        'db-url': { type: 'string' },
+        'db-url-direct': { type: 'string' },
+        'openai-key': { type: 'string' },
+        'anthropic-key': { type: 'string' },
+        agents: { type: 'string' },
+        'api-port': { type: 'string' },
+        'dashboard-port': { type: 'string' },
     },
 });
 const command = positionals[0];
@@ -40,342 +52,303 @@ if (values.help || !command) {
   memoire - Shared context layer for AI coding agents
 
   Usage:
-    memoire setup                       Zero-config: auto-detect everything, bootstrap + install
-    memoire login [options]
-    memoire install [options]
-    memoire uninstall                    Remove Memoire from this project
-    memoire init [options]
-    memoire search <query>
-    memoire usage
-    memoire doctor
-    memoire profile
-    memoire facts
-    memoire resume [query]
-    memoire handoff [query]
-    memoire contexts [list]
-    memoire contexts save [query]
-    memoire contexts get <id>
-    memoire manual [options]
-    memoire hook <name>
-    memoire status
-    memoire dashboard [--port 4310]
-    memoire local-tools [--port 4313]
-    memoire mcp
+    memoire setup                       Interactive wizard — zero to running in one command
+    memoire setup --cloud               Use Memoire Cloud (no database needed)
+    memoire setup --db-url <url>        Self-host with your own Postgres
+    memoire setup --agents cursor,codex Configure specific agents
+    memoire setup --non-interactive     Skip prompts (requires all flags)
+    memoire login [options]             Browser/device auth + install
+    memoire install [options]           Manual install for a single agent
+    memoire uninstall                   Remove Memoire from this project
+    memoire search <query>              Search shared memory
+    memoire usage                       Show usage stats
+    memoire doctor                      Diagnose issues
+    memoire profile                     Show project profile
+    memoire facts                       Show extracted facts
+    memoire resume [query]              Resume previous work
+    memoire handoff [query]             Create a handoff
+    memoire contexts [list|save|get]    Manage saved contexts
+    memoire manual [options]            Show manual setup instructions
+    memoire hook <name>                 Execute IDE hook
+    memoire status                      Check connection
+    memoire dashboard [--port 4310]     Run local dashboard
+    memoire local-tools [--port 4313]   Run local tools server
+    memoire mcp                         Start MCP server (stdio)
 
-  Options:
+  Setup wizard flags:
+    --cloud                 Use Memoire Cloud instead of self-hosting
+    --db-url <url>          Database URL (Postgres/Supabase transaction pooler)
+    --db-url-direct <url>   Direct URL for migrations (session pooler, port 5432)
+    --openai-key <key>      OpenAI API key (optional, for semantic embeddings)
+    --anthropic-key <key>   Anthropic API key (optional, for AI summarization)
+    --agents <list>         Comma-separated: cursor,claude,codex,amp
+    --api-port <port>       API port (default: 3100)
+    --dashboard-port <port> Dashboard port (default: 3200)
+    --non-interactive       Skip all prompts (for CI/scripting)
+    --skip-start            Configure only, don't start API/dashboard
+
+  General options:
     --client, -c      Client type: cursor | claude | codex | amp
     --api-key         Memoire API key (sk_mem_...)
     --api-url         API URL (default: production)
-    --org-id          Organization ID
-    --project-id      Project ID
+    --org-name        Organization name
+    --project-name    Project name
     --user-name       Override detected user name
     --user-email      Override detected user email
     --setup-token     Setup token for bootstrapping additional orgs
-    --invite-token    Join an existing workspace invitation
-    --org-name        Organization name for init
-    --org-slug        Organization slug for init
-    --project-name    Project name for init
-    --project-slug    Project slug for init
-    --config-path     Override ~/.memoire/config.json for dashboard or MCP commands
+    --invite-token    Join an existing workspace invitation (long hex token)
+    --invite-code     Join using a short invite code (e.g. ABCD-1234)
+    --config-path     Override config path for dashboard/MCP
     --client-id       Override the registered client_id for hook or MCP commands
     --port            Dashboard port (default: 4310)
     --allow-origin    Extra dashboard origin allowed to call local tools helper
-    --json            Output as JSON (for piping and automation)
+    --json            Output as JSON
     --help, -h        Show this help
 
   Examples:
-    npx memoire setup                                                     # Zero-config one-liner
-    npx memoire setup --api-url http://localhost:3100                      # Self-hosted
-    npx memoire login                                                      # Browser/device auth + install
-    npx memoire init --client cursor --api-url http://localhost:3100 --org-name Acme
-    npx memoire init --client cursor --api-url http://localhost:3100 --invite-token <token>
-    npx memoire install --client cursor --api-key sk_mem_xxx
-    npx memoire install --client claude --api-key sk_mem_xxx --api-url http://localhost:3100
+    npx memoire setup                                                     # Interactive wizard
+    npx memoire setup --cloud                                             # Cloud hosted
+    npx memoire setup --db-url "postgresql://..." --agents cursor,codex   # Self-hosted
+    npx memoire login                                                      # Browser auth
     npx memoire search "auth decisions"
-    npx memoire usage
     npx memoire doctor
-    npx memoire profile
-    npx memoire facts
-    npx memoire resume "drizzle migrations"
-    npx memoire handoff "oauth callbacks"
-    npx memoire contexts
-    npx memoire contexts save "oauth callbacks"
-    npx memoire contexts get handoff-123
-    npx memoire manual --client codex
-    npx memoire hook cursor-before-submit --client cursor
-    npx memoire status
-    npx memoire dashboard --port 4310
-    npx memoire local-tools --port 4313 --allow-origin https://dashboard.example.com
-    npx memoire mcp
   `);
     process.exit(0);
 }
-if (command === 'setup') {
-    // Zero-config setup: auto-detect client, health-check API, bootstrap + install
-    const apiUrl = values['api-url'];
-    console.log('\n  Memoire Zero-Config Setup\n');
-    // 1. Auto-detect client
-    const client = values.client ?? (await detectClient());
-    if (!client) {
-        console.error('  Could not detect AI client (Cursor, Claude Code, Codex).');
-        console.error('  Use --client to specify one: memoire setup --client cursor');
-        process.exit(1);
-    }
-    console.log(`  Detected client: ${client}`);
-    // 2. Health check API
-    console.log(`  Checking API at ${apiUrl}...`);
-    try {
-        const healthRes = await fetch(`${apiUrl.replace(/\/$/, '')}/health`, {
-            signal: AbortSignal.timeout(5000),
+try {
+    if (command === 'setup') {
+        const { runSetupWizard } = await import('./setup-wizard.js');
+        const defaultApiUrl = 'http://esprit-prod-alb-1025392673.us-east-1.elb.amazonaws.com';
+        await runSetupWizard({
+            apiUrl: values['api-url'] !== defaultApiUrl ? values['api-url'] : undefined,
+            cloud: values.cloud,
+            dbUrl: values['db-url'],
+            dbUrlDirect: values['db-url-direct'],
+            openaiKey: values['openai-key'],
+            anthropicKey: values['anthropic-key'],
+            agents: values.agents,
+            inviteCode: values['invite-code'],
+            orgName: values['org-name'],
+            orgSlug: values['org-slug'],
+            projectName: values['project-name'],
+            projectSlug: values['project-slug'],
+            userName: values['user-name'],
+            userEmail: values['user-email'],
+            setupToken: values['setup-token'],
+            inviteToken: values['invite-token'],
+            apiPort: values['api-port'] ? parseInt(values['api-port'], 10) : undefined,
+            dashboardPort: values['dashboard-port'] ? parseInt(values['dashboard-port'], 10) : undefined,
+            nonInteractive: values['non-interactive'],
+            skipStart: values['skip-start'],
+            json: values.json,
         });
-        if (!healthRes.ok) {
-            console.error(`  API returned ${healthRes.status}. Is the Memoire API running?`);
-            process.exit(1);
-        }
-        console.log('  API is healthy');
-    }
-    catch {
-        console.error(`  Could not reach API at ${apiUrl}`);
-        console.error('  Start the API first or use --api-url to specify the correct URL');
-        process.exit(1);
     }
-    // 3. Check for existing config
-    const { existsSync } = await import('node:fs');
-    const { join } = await import('node:path');
-    const { homedir } = await import('node:os');
-    const existingConfig = join(homedir(), '.memoire', 'config.json');
-    if (existsSync(existingConfig) && !values['api-key']) {
-        console.log('  Found existing config at ~/.memoire/config.json');
-        try {
-            const { readFileSync } = await import('node:fs');
-            const config = JSON.parse(readFileSync(existingConfig, 'utf-8'));
-            if (config.api_key && config.org_id) {
-                console.log('  Re-installing with existing credentials...');
-                await install({
-                    client: client,
-                    apiKey: config.api_key,
-                    apiUrl: config.api_url ?? apiUrl,
-                    orgId: config.org_id,
-                    projectId: config.project_id,
-                    userName: values['user-name'],
-                    userEmail: values['user-email'],
-                });
-                process.exit(0);
-            }
+    else if (command === 'install') {
+        const client = values.client ?? (await detectClient());
+        if (!client) {
+            console.error('Could not detect client. Use --client to specify one.');
+            process.exit(1);
         }
-        catch {
-            // Config unreadable, proceed with fresh init
+        const apiKey = values['api-key'];
+        if (!apiKey) {
+            console.error('API key required. Use --api-key to provide one.');
+            process.exit(1);
         }
+        await install({
+            client: client,
+            apiKey,
+            apiUrl: values['api-url'],
+            orgId: values['org-id'],
+            projectId: values['project-id'],
+            userName: values['user-name'],
+            userEmail: values['user-email'],
+        });
     }
-    // 4. Bootstrap fresh workspace
-    console.log('  Bootstrapping new workspace...');
-    await init({
-        client: client,
-        apiUrl,
-        setupToken: values['setup-token'],
-        inviteToken: values['invite-token'],
-        orgName: values['org-name'],
-        orgSlug: values['org-slug'],
-        projectName: values['project-name'],
-        projectSlug: values['project-slug'],
-        userName: values['user-name'],
-        userEmail: values['user-email'],
-    });
-    console.log('\n  Setup complete! Memoire is ready.\n');
-}
-else if (command === 'install') {
-    const client = values.client ?? (await detectClient());
-    if (!client) {
-        console.error('Could not detect client. Use --client to specify one.');
-        process.exit(1);
-    }
-    const apiKey = values['api-key'];
-    if (!apiKey) {
-        console.error('API key required. Use --api-key to provide one.');
-        process.exit(1);
-    }
-    await install({
-        client: client,
-        apiKey,
-        apiUrl: values['api-url'],
-        orgId: values['org-id'],
-        projectId: values['project-id'],
-        userName: values['user-name'],
-        userEmail: values['user-email'],
-    });
-}
-else if (command === 'uninstall') {
-    await uninstall();
-}
-else if (command === 'login') {
-    await runLoginCommand({
-        client: values.client,
-        apiUrl: values['api-url'],
-        userName: values['user-name'],
-        userEmail: values['user-email'],
-    });
-}
-else if (command === 'init') {
-    const client = values.client ?? (await detectClient());
-    if (!client) {
-        console.error('Could not detect client. Use --client to specify one.');
-        process.exit(1);
-    }
-    await init({
-        client: client,
-        apiUrl: values['api-url'],
-        setupToken: values['setup-token'],
-        inviteToken: values['invite-token'],
-        orgName: values['org-name'],
-        orgSlug: values['org-slug'],
-        projectName: values['project-name'],
-        projectSlug: values['project-slug'],
-        userName: values['user-name'],
-        userEmail: values['user-email'],
-    });
-}
-else if (command === 'search') {
-    const query = positionals.slice(1).join(' ').trim();
-    if (!query) {
-        console.error('Search query required. Example: memoire search "auth decisions"');
-        process.exit(1);
-    }
-    if (values.json) {
-        console.log(JSON.stringify(await runSearchCommandJson(query), null, 2));
-    }
-    else {
-        console.log(await runSearchCommand(query));
+    else if (command === 'uninstall') {
+        await uninstall();
     }
-}
-else if (command === 'status') {
-    if (values.json) {
-        console.log(JSON.stringify(await runStatusCommandJson(), null, 2));
+    else if (command === 'login') {
+        await runLoginCommand({
+            client: values.client,
+            apiUrl: values['api-url'],
+            userName: values['user-name'],
+            userEmail: values['user-email'],
+        });
     }
-    else {
-        console.log(await runStatusCommand());
+    else if (command === 'init') {
+        const client = values.client ?? (await detectClient());
+        if (!client) {
+            console.error('Could not detect client. Use --client to specify one.');
+            process.exit(1);
+        }
+        await init({
+            client: client,
+            apiUrl: values['api-url'],
+            setupToken: values['setup-token'],
+            inviteToken: values['invite-token'],
+            inviteCode: values['invite-code'],
+            orgName: values['org-name'],
+            orgSlug: values['org-slug'],
+            projectName: values['project-name'],
+            projectSlug: values['project-slug'],
+            userName: values['user-name'],
+            userEmail: values['user-email'],
+        });
     }
-}
-else if (command === 'usage') {
-    if (values.json) {
-        console.log(JSON.stringify(await runUsageCommandJson(), null, 2));
+    else if (command === 'search') {
+        const query = positionals.slice(1).join(' ').trim();
+        if (!query) {
+            console.error('Search query required. Example: memoire search "auth decisions"');
+            process.exit(1);
+        }
+        if (values.json) {
+            console.log(JSON.stringify(await runSearchCommandJson(query), null, 2));
+        }
+        else {
+            console.log(await runSearchCommand(query));
+        }
     }
-    else {
-        console.log(await runUsageCommand());
+    else if (command === 'status') {
+        if (values.json) {
+            console.log(JSON.stringify(await runStatusCommandJson(), null, 2));
+        }
+        else {
+            console.log(await runStatusCommand());
+        }
     }
-}
-else if (command === 'doctor') {
-    if (values.json) {
-        console.log(JSON.stringify(await runDoctorCommandJson(), null, 2));
+    else if (command === 'usage') {
+        if (values.json) {
+            console.log(JSON.stringify(await runUsageCommandJson(), null, 2));
+        }
+        else {
+            console.log(await runUsageCommand());
+        }
     }
-    else {
-        console.log(await runDoctorCommand());
+    else if (command === 'doctor') {
+        if (values.json) {
+            console.log(JSON.stringify(await runDoctorCommandJson(), null, 2));
+        }
+        else {
+            console.log(await runDoctorCommand());
+        }
     }
-}
-else if (command === 'profile') {
-    if (values.json) {
-        console.log(JSON.stringify(await runProfileCommandJson(), null, 2));
+    else if (command === 'profile') {
+        if (values.json) {
+            console.log(JSON.stringify(await runProfileCommandJson(), null, 2));
+        }
+        else {
+            console.log(await runProfileCommand());
+        }
     }
-    else {
-        console.log(await runProfileCommand());
+    else if (command === 'facts') {
+        if (values.json) {
+            console.log(JSON.stringify(await runFactsCommandJson(), null, 2));
+        }
+        else {
+            console.log(await runFactsCommand());
+        }
     }
-}
-else if (command === 'facts') {
-    if (values.json) {
-        console.log(JSON.stringify(await runFactsCommandJson(), null, 2));
+    else if (command === 'resume') {
+        console.log(await runResumeCommand(positionals.slice(1).join(' ')));
     }
-    else {
-        console.log(await runFactsCommand());
+    else if (command === 'handoff') {
+        console.log(await runHandoffCommand(positionals.slice(1).join(' ')));
     }
-}
-else if (command === 'resume') {
-    console.log(await runResumeCommand(positionals.slice(1).join(' ')));
-}
-else if (command === 'handoff') {
-    console.log(await runHandoffCommand(positionals.slice(1).join(' ')));
-}
-else if (command === 'contexts') {
-    const subcommand = positionals[1] ?? 'list';
-    if (subcommand === 'list') {
-        if (values.json) {
-            console.log(JSON.stringify(await runContextsListCommandJson(), null, 2));
+    else if (command === 'contexts') {
+        const subcommand = positionals[1] ?? 'list';
+        if (subcommand === 'list') {
+            if (values.json) {
+                console.log(JSON.stringify(await runContextsListCommandJson(), null, 2));
+            }
+            else {
+                console.log(await runContextsListCommand());
+            }
+        }
+        else if (subcommand === 'save') {
+            console.log(await runHandoffCommand(positionals.slice(2).join(' ')));
+        }
+        else if (subcommand === 'get') {
+            const handoffId = positionals[2]?.trim();
+            if (!handoffId) {
+                console.error('Context ID required. Example: memoire contexts get <id>');
+                process.exit(1);
+            }
+            if (values.json) {
+                console.log(JSON.stringify(await runContextsGetCommandJson(handoffId), null, 2));
+            }
+            else {
+                console.log(await runContextsGetCommand(handoffId));
+            }
         }
         else {
-            console.log(await runContextsListCommand());
+            console.error(`Unknown contexts command: ${subcommand}`);
+            console.error('Use: memoire contexts [list|save|get]');
+            process.exit(1);
         }
     }
-    else if (subcommand === 'save') {
-        console.log(await runHandoffCommand(positionals.slice(2).join(' ')));
+    else if (command === 'manual') {
+        console.log(await runManualSetupCommand({
+            client: values.client,
+            configPath: values['config-path'],
+        }));
     }
-    else if (subcommand === 'get') {
-        const handoffId = positionals[2]?.trim();
-        if (!handoffId) {
-            console.error('Context ID required. Example: memoire contexts get <id>');
+    else if (command === 'dashboard') {
+        const parsedPort = values.port ? Number.parseInt(values.port, 10) : undefined;
+        if (values.port && !Number.isFinite(parsedPort)) {
+            console.error('Port must be a number.');
             process.exit(1);
         }
-        if (values.json) {
-            console.log(JSON.stringify(await runContextsGetCommandJson(handoffId), null, 2));
+        await runDashboardCommand({
+            port: parsedPort,
+            configPath: values['config-path'],
+        });
+    }
+    else if (command === 'local-tools') {
+        const parsedPort = values.port ? Number.parseInt(values.port, 10) : undefined;
+        if (values.port && !Number.isFinite(parsedPort)) {
+            console.error('Port must be a number.');
+            process.exit(1);
         }
-        else {
-            console.log(await runContextsGetCommand(handoffId));
+        await runLocalToolsCommand({
+            port: parsedPort,
+            configPath: values['config-path'],
+            allowOrigin: values['allow-origin'],
+        });
+    }
+    else if (command === 'mcp') {
+        await runMcpCommand({
+            ...process.env,
+            ...(values['config-path'] ? { MEMOIRE_CONFIG_PATH: values['config-path'] } : {}),
+            ...(values['client-id'] ? { MEMOIRE_CLIENT_ID: values['client-id'] } : {}),
+        });
+    }
+    else if (command === 'hook') {
+        const hookName = positionals[1];
+        if (!hookName) {
+            console.error('Hook name required. Example: memoire hook cursor-before-submit --client cursor');
+            process.exit(1);
         }
+        await runHookCommand({
+            hookName,
+            client: values.client,
+            clientId: values['client-id'],
+            configPath: values['config-path'],
+        });
     }
     else {
-        console.error(`Unknown contexts command: ${subcommand}`);
-        console.error('Use: memoire contexts [list|save|get]');
-        process.exit(1);
-    }
-}
-else if (command === 'manual') {
-    console.log(await runManualSetupCommand({
-        client: values.client,
-        configPath: values['config-path'],
-    }));
-}
-else if (command === 'dashboard') {
-    const parsedPort = values.port ? Number.parseInt(values.port, 10) : undefined;
-    if (values.port && !Number.isFinite(parsedPort)) {
-        console.error('Port must be a number.');
+        console.error(`Unknown command: ${command}`);
         process.exit(1);
     }
-    await runDashboardCommand({
-        port: parsedPort,
-        configPath: values['config-path'],
-    });
 }
-else if (command === 'local-tools') {
-    const parsedPort = values.port ? Number.parseInt(values.port, 10) : undefined;
-    if (values.port && !Number.isFinite(parsedPort)) {
-        console.error('Port must be a number.');
-        process.exit(1);
+catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes('config not found') || msg.includes('Not authenticated')) {
+        console.error(`\n  ${msg}\n`);
+        console.error('  Run: npx memoire-ai setup\n');
     }
-    await runLocalToolsCommand({
-        port: parsedPort,
-        configPath: values['config-path'],
-        allowOrigin: values['allow-origin'],
-    });
-}
-else if (command === 'mcp') {
-    await runMcpCommand({
-        ...process.env,
-        ...(values['config-path'] ? { MEMOIRE_CONFIG_PATH: values['config-path'] } : {}),
-        ...(values['client-id'] ? { MEMOIRE_CLIENT_ID: values['client-id'] } : {}),
-    });
-}
-else if (command === 'hook') {
-    const hookName = positionals[1];
-    if (!hookName) {
-        console.error('Hook name required. Example: memoire hook cursor-before-submit --client cursor');
-        process.exit(1);
+    else {
+        console.error(`\n  Error: ${msg}\n`);
     }
-    await runHookCommand({
-        hookName,
-        client: values.client,
-        clientId: values['client-id'],
-        configPath: values['config-path'],
-    });
-}
-else {
-    console.error(`Unknown command: ${command}`);
     process.exit(1);
 }
 //# sourceMappingURL=cli.js.map