create-snipara 1.0.0 → 1.1.0

package/dist/index.js

@@ -9,11 +9,11 @@ import fs from "fs";
 import path from "path";
 import { execSync } from "child_process";
 import { homedir } from "os";
-var VERSION = "1.0.0";
+var VERSION = "1.1.0";
 var BASE_URL = "https://www.snipara.com";
 var API_URL = "https://api.snipara.com";
 async function main() {
-  program.name("create-snipara").description("Initialize Snipara MCP + RLM-Runtime with a single command").version(VERSION).option("--api-key <key>", "Snipara API key (project or team)").option("--slug <slug>", "Project slug").option("--project-id <id>", "Project ID (optional, for advanced use)").option("--skip-mcp", "Skip snipara-mcp installation").option("--skip-runtime", "Skip rlm-runtime installation").option("--skip-hooks", "Skip hooks installation").option("--skip-test", "Skip connection test").option("-y, --yes", "Accept defaults without prompting").parse();
+  program.name("create-snipara").description("Initialize Snipara MCP + RLM-Runtime with a single command").version(VERSION).option("--api-key <key>", "Snipara API key (project or team)").option("--team-key <key>", "Team API key (access all team projects)").option("--slug <slug>", "Project slug").option("--project-id <id>", "Project ID (optional, for advanced use)").option("--skip-mcp", "Skip snipara-mcp installation").option("--skip-runtime", "Skip rlm-runtime installation").option("--skip-hooks", "Skip hooks installation").option("--skip-test", "Skip connection test").option("--runtime-only", "Install only RLM-Runtime (no API key needed for local execution)").option("-y, --yes", "Accept defaults without prompting").parse();
   const options = program.opts();
   printBanner();
   const answers = await gatherConfiguration(options);
@@ -57,11 +57,29 @@ async function gatherConfiguration(options) {
     detectedSlug = existingConfig.slug || detectedSlug;
     detectedProjectId = existingConfig.projectId || "";
   }
+  if (options.runtimeOnly) {
+    console.log(chalk.cyan("\n   \u2139\uFE0F  Runtime-only mode: No API key needed for local code execution\n"));
+    console.log(chalk.dim("   execute_python works without any API key when used in Claude Code."));
+    console.log(chalk.dim("   For rlm run/agent CLI, you'll need OPENAI_API_KEY or ANTHROPIC_API_KEY.\n"));
+    return {
+      projectSlug: options.slug || detectedSlug || "my-project",
+      projectId: "",
+      apiKey: "",
+      apiKeyType: "none",
+      installMcp: false,
+      installRuntime: true,
+      installHooks: false,
+      aiClient: detectedClient
+    };
+  }
   if (options.yes) {
+    const apiKey2 = options.teamKey || options.apiKey || "YOUR_API_KEY_HERE";
+    const apiKeyType2 = options.teamKey ? "team" : "project";
     return {
       projectSlug: options.slug || detectedSlug || "my-project",
       projectId: options.projectId || detectedProjectId,
-      apiKey: options.apiKey || "YOUR_API_KEY_HERE",
+      apiKey: apiKey2,
+      apiKeyType: apiKeyType2,
       installMcp: !options.skipMcp,
       installRuntime: !options.skipRuntime,
       installHooks: !options.skipHooks && detectedClient === "claude-code",
@@ -83,19 +101,34 @@ async function gatherConfiguration(options) {
       initial: options.projectId || detectedProjectId || ""
     },
     {
-      type: options.apiKey ? null : "select",
-      name: "authMethod",
-      message: "How would you like to authenticate?",
+      type: options.apiKey || options.teamKey ? null : "select",
+      name: "apiKeyType",
+      message: "What type of API key do you have?",
       choices: [
-        { title: "I have a Snipara API key", value: "existing" },
-        { title: "Sign up for free (100 queries/mo)", value: "signup" },
-        { title: "I'll add the API key later", value: "skip" }
+        {
+          title: "Project API key",
+          value: "project",
+          description: "Access to a single project"
+        },
+        {
+          title: "Team API key",
+          value: "team",
+          description: "Access to all projects in your team"
+        },
+        {
+          title: "Sign up for free (100 queries/mo)",
+          value: "signup"
+        },
+        {
+          title: "I'll add the API key later",
+          value: "skip"
+        }
       ]
     },
     {
-      type: (prev, values) => values.authMethod === "existing" ? "text" : null,
+      type: (prev, values) => values.apiKeyType === "project" || values.apiKeyType === "team" ? "text" : null,
       name: "apiKey",
-      message: "Enter your API key:",
+      message: (prev, values) => values.apiKeyType === "team" ? "Enter your Team API key:" : "Enter your Project API key:",
       validate: (v) => v.startsWith("rlm_") ? true : "API key should start with rlm_"
     },
     {
@@ -133,13 +166,13 @@ async function gatherConfiguration(options) {
           title: "snipara-mcp",
           value: "mcp",
           selected: !options.skipMcp,
-          description: "MCP server for context queries"
+          description: "MCP server for context queries (requires API key)"
         },
         {
           title: "rlm-runtime",
           value: "runtime",
           selected: !options.skipRuntime,
-          description: "Safe code execution with Docker"
+          description: "Safe code execution (no API key for execute_python)"
         },
         {
           title: "Claude Code hooks",
@@ -151,23 +184,80 @@ async function gatherConfiguration(options) {
       hint: "Space to toggle, Enter to confirm"
     }
   ]);
-  let apiKey = options.apiKey;
-  if (response.authMethod === "signup") {
-    apiKey = await handleSignup();
-  } else if (response.authMethod === "existing") {
-    apiKey = response.apiKey;
-  } else if (response.authMethod === "skip") {
-    apiKey = "YOUR_API_KEY_HERE";
+  let apiKey = options.teamKey || options.apiKey;
+  let apiKeyType = options.teamKey ? "team" : "project";
+  if (!apiKey) {
+    if (response.apiKeyType === "signup") {
+      apiKey = await handleSignup();
+      apiKeyType = "project";
+    } else if (response.apiKeyType === "project" || response.apiKeyType === "team") {
+      apiKey = response.apiKey;
+      apiKeyType = response.apiKeyType;
+    } else if (response.apiKeyType === "skip") {
+      apiKey = "YOUR_API_KEY_HERE";
+      apiKeyType = "none";
+    }
   }
   const packages = response.packages || [];
+  let llmProvider;
+  let llmApiKey;
+  if (packages.includes("runtime")) {
+    console.log(chalk.cyan("\n   \u2139\uFE0F  RLM-Runtime API Key Info:\n"));
+    console.log(chalk.dim("   \u2022 execute_python MCP tool: No LLM API key needed"));
+    console.log(chalk.dim("     (Your AI client - Claude, GPT, etc. - provides the LLM)"));
+    console.log(chalk.dim("   \u2022 rlm run / rlm agent CLI: Requires an LLM API key\n"));
+    const llmResponse = await prompts([
+      {
+        type: "select",
+        name: "llmProvider",
+        message: "Will you use rlm run/agent CLI? (requires LLM API key)",
+        choices: [
+          {
+            title: "No - I'll only use execute_python in my AI client",
+            value: "none",
+            description: "No additional API key needed"
+          },
+          {
+            title: "Yes - OpenAI (GPT-4, etc.)",
+            value: "openai",
+            description: "Requires OPENAI_API_KEY"
+          },
+          {
+            title: "Yes - Anthropic (Claude)",
+            value: "anthropic",
+            description: "Requires ANTHROPIC_API_KEY"
+          }
+        ]
+      },
+      {
+        type: (prev) => prev !== "none" ? "text" : null,
+        name: "llmApiKey",
+        message: (prev) => prev === "openai" ? "Enter your OpenAI API key (sk-...):" : "Enter your Anthropic API key (sk-ant-...):",
+        validate: (v, values) => {
+          if (values.llmProvider === "openai" && !v.startsWith("sk-")) {
+            return "OpenAI key should start with sk-";
+          }
+          if (values.llmProvider === "anthropic" && !v.startsWith("sk-ant-")) {
+            return "Anthropic key should start with sk-ant-";
+          }
+          return true;
+        }
+      }
+    ]);
+    llmProvider = llmResponse.llmProvider;
+    llmApiKey = llmResponse.llmApiKey;
+  }
   return {
     projectSlug: response.projectSlug,
     projectId: response.projectId || "",
     apiKey: apiKey || "YOUR_API_KEY_HERE",
+    apiKeyType,
     installMcp: packages.includes("mcp"),
     installRuntime: packages.includes("runtime"),
     installHooks: packages.includes("hooks"),
-    aiClient: response.aiClient || detectedClient
+    aiClient: response.aiClient || detectedClient,
+    llmProvider,
+    llmApiKey
   };
 }
 async function handleSignup() {
@@ -474,12 +564,27 @@ async function updateEnvFiles(answers) {
   const envExamplePath = path.join(process.cwd(), ".env.example");
   const envLocalPath = path.join(process.cwd(), ".env.local");
   const envPath = path.join(process.cwd(), ".env");
-  const envVars = `
+  let envVars = "";
+  if (answers.apiKeyType !== "none") {
+    envVars += `
 # Snipara Configuration
 SNIPARA_API_KEY=${answers.apiKey.includes("YOUR_") ? "your_api_key_here" : answers.apiKey}
 SNIPARA_PROJECT_SLUG=${answers.projectSlug}
 ${answers.projectId ? `SNIPARA_PROJECT_ID=${answers.projectId}` : ""}
 `.trim();
+  }
+  if (answers.llmProvider && answers.llmProvider !== "none" && answers.llmApiKey) {
+    const llmVarName = answers.llmProvider === "openai" ? "OPENAI_API_KEY" : "ANTHROPIC_API_KEY";
+    envVars += `
+
+# RLM-Runtime LLM Provider (for rlm run/agent CLI)
+${llmVarName}=${answers.llmApiKey}`;
+  }
+  envVars = envVars.trim();
+  if (!envVars) {
+    console.log(chalk.dim("   No environment variables to save"));
+    return;
+  }
   if (fs.existsSync(envExamplePath)) {
     const content = fs.readFileSync(envExamplePath, "utf-8");
     if (!content.includes("SNIPARA_API_KEY")) {
@@ -561,9 +666,23 @@ function printSuccess(answers) {
   if (answers.installHooks) {
     console.log(chalk.green("   \u2713 Claude Code hooks") + chalk.dim(" - Session memory automation"));
   }
-  console.log(chalk.green("   \u2713 .mcp.json") + chalk.dim(" - MCP server configuration"));
+  if (answers.apiKeyType !== "none") {
+    console.log(chalk.green("   \u2713 .mcp.json") + chalk.dim(" - MCP server configuration"));
+  }
+  if (answers.apiKeyType === "team") {
+    console.log(chalk.cyan("\n   \u{1F511} Using Team API key - access to all team projects"));
+  } else if (answers.apiKeyType === "project") {
+    console.log(chalk.dim(`
+   \u{1F511} Using Project API key for: ${answers.projectSlug}`));
+  }
   console.log(chalk.bold("\nNext steps:\n"));
-  if (answers.apiKey.includes("YOUR_")) {
+  if (answers.apiKeyType === "none" && answers.installRuntime) {
+    console.log("  1. Restart your AI client (Claude Code, Cursor, etc.)");
+    console.log("  2. Use execute_python MCP tool - no API key needed!");
+    console.log(chalk.dim("\n  For rlm run/agent CLI, set one of these env vars:"));
+    console.log(chalk.dim("     export OPENAI_API_KEY=sk-..."));
+    console.log(chalk.dim("     export ANTHROPIC_API_KEY=sk-ant-..."));
+  } else if (answers.apiKey.includes("YOUR_") || answers.apiKeyType === "none") {
     console.log(`  1. Get your API key at ${chalk.cyan(`${BASE_URL}/signup`)}`);
     console.log("  2. Update SNIPARA_API_KEY in .mcp.json");
     console.log("  3. Restart your AI client");
@@ -573,11 +692,22 @@ function printSuccess(answers) {
     console.log("  3. Start using MCP tools like rlm_context_query");
   }
   if (answers.installRuntime) {
-    console.log(chalk.bold("\nRLM-Runtime commands:\n"));
-    console.log(chalk.dim("   rlm init              # Initialize configuration"));
-    console.log(chalk.dim("   rlm run --env docker  # Run with Docker isolation"));
-    console.log(chalk.dim("   rlm serve             # Start MCP server"));
-    console.log(chalk.dim("   rlm visualize         # Launch trajectory dashboard"));
+    console.log(chalk.bold("\nRLM-Runtime:\n"));
+    console.log(chalk.dim("   MCP tools (no LLM API key needed - your AI client provides the LLM):"));
+    console.log(chalk.dim("     \u2022 execute_python    - Run Python in sandbox"));
+    console.log(chalk.dim("     \u2022 get_repl_context  - Get session variables"));
+    if (answers.llmProvider && answers.llmProvider !== "none") {
+      const providerName = answers.llmProvider === "openai" ? "OpenAI" : "Anthropic";
+      console.log(chalk.dim(`
+   CLI commands (using ${providerName}):`));
+      console.log(chalk.dim("     \u2022 rlm run           - Run with LLM orchestration"));
+      console.log(chalk.dim("     \u2022 rlm agent         - Autonomous agent mode"));
+      console.log(chalk.dim("     \u2022 rlm visualize     - Trajectory dashboard"));
+    } else {
+      console.log(chalk.dim("\n   CLI commands (not configured - set LLM API key later if needed):"));
+      console.log(chalk.dim("     \u2022 rlm run           - Requires OPENAI_API_KEY or ANTHROPIC_API_KEY"));
+      console.log(chalk.dim("     \u2022 rlm agent         - Requires OPENAI_API_KEY or ANTHROPIC_API_KEY"));
+    }
   }
   console.log(chalk.dim(`
   Docs: ${BASE_URL}/docs`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-snipara",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Initialize Snipara MCP + RLM-Runtime with a single command - context optimization, semantic memory, and safe code execution",
   "main": "dist/index.js",
   "type": "module",