create-snipara 1.0.0

package/README.md

@@ -0,0 +1,140 @@
+# create-snipara
+
+One-command setup for **Snipara MCP + RLM-Runtime** - context optimization, semantic memory, and safe code execution for AI agents.
+
+```bash
+npx create-snipara
+```
+
+## What It Does
+
+- **Installs snipara-mcp** - MCP server for context-optimized documentation queries
+- **Installs rlm-runtime** - Safe code execution with Docker isolation
+- **Configures .mcp.json** - Ready for Claude Code, Cursor, Claude Desktop
+- **Sets up hooks** - Session memory automation (Claude Code)
+- **Updates environment files** - Adds API key configuration
+
+## Interactive Setup
+
+```bash
+npx create-snipara
+```
+
+You'll be prompted for:
+
+| Prompt | Description |
+|--------|-------------|
+| **Project slug** | Auto-detected from git remote or directory name |
+| **Project ID** | Optional, for advanced use cases |
+| **API key** | Your Snipara API key (or sign up for free) |
+| **AI client** | Claude Code, Cursor, Claude Desktop, or other |
+| **Packages** | Choose what to install |
+
+## Command Line Options
+
+```bash
+# Use existing API key
+npx create-snipara --api-key rlm_your_key_here
+
+# Specify project slug
+npx create-snipara --slug my-project
+
+# Skip specific installations
+npx create-snipara --skip-mcp      # Skip snipara-mcp
+npx create-snipara --skip-runtime  # Skip rlm-runtime
+npx create-snipara --skip-hooks    # Skip Claude Code hooks
+
+# Accept all defaults
+npx create-snipara -y
+
+# Full example
+npx create-snipara --api-key rlm_xxx --slug my-project --skip-hooks
+```
+
+## What Gets Created
+
+### .mcp.json
+
+```json
+{
+  "mcpServers": {
+    "snipara": {
+      "type": "http",
+      "url": "https://api.snipara.com/mcp/your-project",
+      "headers": {
+        "X-API-Key": "rlm_your_key"
+      }
+    },
+    "rlm-runtime": {
+      "type": "http",
+      "url": "http://localhost:8765/mcp",
+      "headers": {}
+    }
+  }
+}
+```
+
+### Claude Code Hooks (if selected)
+
+- `snipara-startup.sh` - Restores session context
+- `snipara-session.sh` - Auto-remembers commits
+- `snipara-compact.sh` - Saves context before compaction
+
+### Environment Files
+
+Updates `.env.example` and `.env.local` with:
+
+```bash
+SNIPARA_API_KEY=your_api_key
+SNIPARA_PROJECT_SLUG=your-project
+```
+
+## After Installation
+
+### For Claude Code / Cursor
+
+1. Restart your AI client
+2. MCP tools are automatically available
+
+### For Claude Desktop
+
+1. Restart Claude Desktop
+2. Config is at `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+### RLM-Runtime Commands
+
+```bash
+rlm init              # Initialize configuration
+rlm run --env docker  # Run with Docker isolation
+rlm serve             # Start MCP server
+rlm visualize         # Launch trajectory dashboard
+```
+
+## Available MCP Tools
+
+After setup, you have access to 43+ MCP tools:
+
+| Category | Tools |
+|----------|-------|
+| **Context** | `rlm_context_query`, `rlm_ask`, `rlm_search`, `rlm_sections` |
+| **Planning** | `rlm_plan`, `rlm_decompose`, `rlm_multi_query` |
+| **Memory** | `rlm_remember`, `rlm_recall`, `rlm_memories`, `rlm_forget` |
+| **Execution** | `execute_python`, `rlm_agent_run` (via RLM-Runtime) |
+| **Swarms** | `rlm_swarm_create`, `rlm_claim`, `rlm_task_create` |
+
+## Requirements
+
+- Node.js 18+
+- Python 3.10+ (for snipara-mcp and rlm-runtime)
+- Docker (optional, for RLM-Runtime isolation)
+
+## Links
+
+- **Website**: https://snipara.com
+- **Documentation**: https://snipara.com/docs
+- **Dashboard**: https://snipara.com/dashboard
+- **Support**: hello@snipara.com
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,645 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { program } from "commander";
+import prompts from "prompts";
+import chalk from "chalk";
+import ora from "ora";
+import fs from "fs";
+import path from "path";
+import { execSync } from "child_process";
+import { homedir } from "os";
+var VERSION = "1.0.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();
+  const options = program.opts();
+  printBanner();
+  const answers = await gatherConfiguration(options);
+  if (answers.installMcp || answers.installRuntime) {
+    await installPythonPackages(answers);
+  }
+  await createMcpConfig(answers);
+  if (answers.installHooks && answers.aiClient === "claude-code") {
+    await installClaudeCodeHooks(answers);
+  }
+  await updateEnvFiles(answers);
+  if (!options.skipTest && answers.apiKey && !answers.apiKey.includes("YOUR_")) {
+    await testConnection(answers);
+  }
+  printSuccess(answers);
+}
+function printBanner() {
+  console.log(
+    chalk.cyan(`
+\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
+\u2551                                                                       \u2551
+\u2551   ${chalk.bold("Snipara")} - Context Optimization + RLM-Runtime                      \u2551
+\u2551                                                                       \u2551
+\u2551   \u2022 90% context reduction for LLM queries                             \u2551
+\u2551   \u2022 Semantic memory across sessions                                   \u2551
+\u2551   \u2022 Safe code execution with Docker isolation                         \u2551
+\u2551   \u2022 Multi-agent coordination                                          \u2551
+\u2551                                                                       \u2551
+\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+`)
+  );
+}
+async function gatherConfiguration(options) {
+  console.log(chalk.bold("\n\u{1F4CB} Project Configuration\n"));
+  let detectedSlug = detectProjectSlug();
+  let detectedProjectId = "";
+  const detectedClient = detectAiClient();
+  const existingConfig = getExistingConfig();
+  if (existingConfig) {
+    console.log(chalk.dim("   Found existing .mcp.json configuration"));
+    detectedSlug = existingConfig.slug || detectedSlug;
+    detectedProjectId = existingConfig.projectId || "";
+  }
+  if (options.yes) {
+    return {
+      projectSlug: options.slug || detectedSlug || "my-project",
+      projectId: options.projectId || detectedProjectId,
+      apiKey: options.apiKey || "YOUR_API_KEY_HERE",
+      installMcp: !options.skipMcp,
+      installRuntime: !options.skipRuntime,
+      installHooks: !options.skipHooks && detectedClient === "claude-code",
+      aiClient: detectedClient
+    };
+  }
+  const response = await prompts([
+    {
+      type: "text",
+      name: "projectSlug",
+      message: "Project slug:",
+      initial: options.slug || detectedSlug || "",
+      validate: (v) => v.length > 0 ? true : "Project slug is required (e.g., my-project)"
+    },
+    {
+      type: "text",
+      name: "projectId",
+      message: "Project ID (optional, press Enter to skip):",
+      initial: options.projectId || detectedProjectId || ""
+    },
+    {
+      type: options.apiKey ? null : "select",
+      name: "authMethod",
+      message: "How would you like to authenticate?",
+      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" }
+      ]
+    },
+    {
+      type: (prev, values) => values.authMethod === "existing" ? "text" : null,
+      name: "apiKey",
+      message: "Enter your API key:",
+      validate: (v) => v.startsWith("rlm_") ? true : "API key should start with rlm_"
+    },
+    {
+      type: "select",
+      name: "aiClient",
+      message: "Which AI client are you using?",
+      initial: ["claude-code", "cursor", "claude-desktop", "other"].indexOf(
+        detectedClient
+      ),
+      choices: [
+        {
+          title: "Claude Code (CLI/VS Code extension)",
+          value: "claude-code",
+          description: "Full hooks support"
+        },
+        {
+          title: "Cursor",
+          value: "cursor",
+          description: "MCP support via .mcp.json"
+        },
+        {
+          title: "Claude Desktop",
+          value: "claude-desktop",
+          description: "MCP support via config file"
+        },
+        { title: "Other", value: "other" }
+      ]
+    },
+    {
+      type: "multiselect",
+      name: "packages",
+      message: "What would you like to install?",
+      choices: [
+        {
+          title: "snipara-mcp",
+          value: "mcp",
+          selected: !options.skipMcp,
+          description: "MCP server for context queries"
+        },
+        {
+          title: "rlm-runtime",
+          value: "runtime",
+          selected: !options.skipRuntime,
+          description: "Safe code execution with Docker"
+        },
+        {
+          title: "Claude Code hooks",
+          value: "hooks",
+          selected: !options.skipHooks,
+          description: "Session memory & automation (Claude Code only)"
+        }
+      ],
+      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";
+  }
+  const packages = response.packages || [];
+  return {
+    projectSlug: response.projectSlug,
+    projectId: response.projectId || "",
+    apiKey: apiKey || "YOUR_API_KEY_HERE",
+    installMcp: packages.includes("mcp"),
+    installRuntime: packages.includes("runtime"),
+    installHooks: packages.includes("hooks"),
+    aiClient: response.aiClient || detectedClient
+  };
+}
+async function handleSignup() {
+  const signupUrl = `${BASE_URL}/signup`;
+  console.log(chalk.cyan(`
+   Opening ${signupUrl} in your browser...
+`));
+  try {
+    const openCmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+    execSync(`${openCmd} "${signupUrl}"`, { stdio: "ignore" });
+  } catch {
+    console.log(
+      chalk.yellow(`   Could not open browser. Please visit:
+   ${signupUrl}
+`)
+    );
+  }
+  console.log(
+    chalk.dim(
+      "   After signing up, create a project and copy your API key.\n"
+    )
+  );
+  const response = await prompts({
+    type: "text",
+    name: "key",
+    message: "Paste your API key here:",
+    validate: (v) => v.startsWith("rlm_") ? true : "API key should start with rlm_"
+  });
+  return response.key;
+}
+async function installPythonPackages(answers) {
+  console.log(chalk.bold("\n\u{1F4E6} Installing Python Packages\n"));
+  const pipCmd = detectPipCommand();
+  if (!pipCmd) {
+    console.log(
+      chalk.yellow(
+        "   \u26A0\uFE0F  Python pip not found. Please install packages manually:\n"
+      )
+    );
+    if (answers.installMcp) {
+      console.log(chalk.gray("      pip install snipara-mcp"));
+    }
+    if (answers.installRuntime) {
+      console.log(chalk.gray("      pip install rlm-runtime[all]"));
+    }
+    console.log("");
+    return;
+  }
+  const packages = [];
+  if (answers.installMcp) {
+    packages.push("snipara-mcp");
+  }
+  if (answers.installRuntime) {
+    packages.push("rlm-runtime[all]");
+  }
+  if (packages.length === 0) return;
+  const spinner = ora(`Installing ${packages.join(", ")}...`).start();
+  try {
+    const installCmd = pipCmd === "uv" ? `uv pip install ${packages.join(" ")}` : `${pipCmd} install ${packages.join(" ")}`;
+    execSync(installCmd, {
+      stdio: "pipe",
+      encoding: "utf-8"
+    });
+    spinner.succeed(`Installed ${packages.join(", ")}`);
+  } catch (error) {
+    spinner.fail(`Failed to install packages`);
+    console.log(chalk.yellow("\n   Install manually with:"));
+    console.log(chalk.gray(`   pip install ${packages.join(" ")}
+`));
+  }
+}
+async function createMcpConfig(answers) {
+  console.log(chalk.bold("\n\u2699\uFE0F  Creating Configuration\n"));
+  const mcpConfigPath = path.join(process.cwd(), ".mcp.json");
+  let mcpConfig = { mcpServers: {} };
+  if (fs.existsSync(mcpConfigPath)) {
+    try {
+      mcpConfig = JSON.parse(fs.readFileSync(mcpConfigPath, "utf-8"));
+      console.log(chalk.dim("   Found existing .mcp.json, merging..."));
+    } catch {
+      console.log(
+        chalk.yellow("   Could not parse existing .mcp.json, creating new...")
+      );
+    }
+  }
+  mcpConfig.mcpServers["snipara"] = {
+    type: "http",
+    url: `${API_URL}/mcp/${answers.projectSlug}`,
+    headers: {
+      "X-API-Key": answers.apiKey
+    }
+  };
+  if (answers.installRuntime) {
+    mcpConfig.mcpServers["rlm-runtime"] = {
+      type: "http",
+      url: "http://localhost:8765/mcp",
+      headers: {}
+    };
+  }
+  fs.writeFileSync(mcpConfigPath, JSON.stringify(mcpConfig, null, 2) + "\n");
+  console.log(chalk.green("   \u2713 Created .mcp.json"));
+  const gitignorePath = path.join(process.cwd(), ".gitignore");
+  if (fs.existsSync(gitignorePath)) {
+    const gitignore = fs.readFileSync(gitignorePath, "utf-8");
+    if (!gitignore.includes(".mcp.json")) {
+      fs.appendFileSync(
+        gitignorePath,
+        "\n# Snipara MCP config (contains API key)\n.mcp.json\n"
+      );
+      console.log(chalk.green("   \u2713 Added .mcp.json to .gitignore"));
+    }
+  } else {
+    fs.writeFileSync(
+      gitignorePath,
+      "# Snipara MCP config (contains API key)\n.mcp.json\n"
+    );
+    console.log(chalk.green("   \u2713 Created .gitignore with .mcp.json"));
+  }
+  if (answers.aiClient === "claude-desktop") {
+    await createClaudeDesktopConfig(answers);
+  }
+}
+async function createClaudeDesktopConfig(answers) {
+  const configDir = process.platform === "darwin" ? path.join(homedir(), "Library", "Application Support", "Claude") : process.platform === "win32" ? path.join(homedir(), "AppData", "Roaming", "Claude") : path.join(homedir(), ".config", "claude");
+  const configPath = path.join(configDir, "claude_desktop_config.json");
+  console.log(chalk.dim(`
+   Claude Desktop config: ${configPath}`));
+  try {
+    if (!fs.existsSync(configDir)) {
+      fs.mkdirSync(configDir, { recursive: true });
+    }
+    let config = {};
+    if (fs.existsSync(configPath)) {
+      config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    }
+    config.mcpServers = config.mcpServers || {};
+    config.mcpServers["snipara"] = {
+      command: "uvx",
+      args: ["snipara-mcp"],
+      env: {
+        SNIPARA_API_KEY: answers.apiKey,
+        SNIPARA_PROJECT_SLUG: answers.projectSlug
+      }
+    };
+    if (answers.installRuntime) {
+      config.mcpServers["rlm-runtime"] = {
+        command: "rlm",
+        args: ["serve"],
+        env: {
+          SNIPARA_API_KEY: answers.apiKey,
+          SNIPARA_PROJECT_SLUG: answers.projectSlug
+        }
+      };
+    }
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+    console.log(chalk.green("   \u2713 Updated Claude Desktop config"));
+  } catch (error) {
+    console.log(
+      chalk.yellow(`   \u26A0\uFE0F  Could not update Claude Desktop config: ${error}`)
+    );
+  }
+}
+async function installClaudeCodeHooks(answers) {
+  console.log(chalk.bold("\n\u{1FA9D} Installing Claude Code Hooks\n"));
+  const claudeDir = path.join(homedir(), ".claude");
+  const hooksDir = path.join(claudeDir, "hooks");
+  if (!fs.existsSync(claudeDir)) {
+    console.log(
+      chalk.yellow(
+        "   \u26A0\uFE0F  ~/.claude not found. Install Claude Code first, then run:\n"
+      )
+    );
+    console.log(chalk.gray("      create-snipara --skip-mcp --skip-runtime\n"));
+    return;
+  }
+  if (!fs.existsSync(hooksDir)) {
+    fs.mkdirSync(hooksDir, { recursive: true });
+  }
+  const hooks = [
+    {
+      name: "snipara-startup.sh",
+      event: "PreToolUse",
+      content: createStartupHook(answers)
+    },
+    {
+      name: "snipara-session.sh",
+      event: "PostToolUse",
+      content: createSessionHook(answers)
+    },
+    {
+      name: "snipara-compact.sh",
+      event: "PreCompact",
+      content: createCompactHook(answers)
+    }
+  ];
+  for (const hook of hooks) {
+    const hookPath = path.join(hooksDir, hook.name);
+    fs.writeFileSync(hookPath, hook.content);
+    fs.chmodSync(hookPath, "755");
+    console.log(chalk.green(`   \u2713 Created ${hook.name}`));
+  }
+  const settingsPath = path.join(claudeDir, "settings.json");
+  let settings = {};
+  if (fs.existsSync(settingsPath)) {
+    try {
+      settings = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+    } catch {
+    }
+  }
+  settings.hooks = settings.hooks || {};
+  const hooksConfig = settings.hooks;
+  const hookEntries = [
+    {
+      event: "PreToolUse",
+      script: path.join(hooksDir, "snipara-startup.sh"),
+      matcher: { tool_name: "TodoWrite" }
+    },
+    {
+      event: "PostToolUse",
+      script: path.join(hooksDir, "snipara-session.sh"),
+      matcher: { tool_name: "Bash" }
+    },
+    {
+      event: "PreCompact",
+      script: path.join(hooksDir, "snipara-compact.sh")
+    }
+  ];
+  for (const entry of hookEntries) {
+    const eventHooks = hooksConfig[entry.event] || [];
+    const exists = eventHooks.some(
+      (h) => typeof h === "object" && h !== null && "script" in h && h.script === entry.script
+    );
+    if (!exists) {
+      eventHooks.push(entry);
+      hooksConfig[entry.event] = eventHooks;
+    }
+  }
+  settings.hooks = hooksConfig;
+  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+  console.log(chalk.green("   \u2713 Updated ~/.claude/settings.json"));
+}
+function createStartupHook(answers) {
+  return `#!/bin/bash
+# Snipara Startup Hook - Restores session context
+# Event: PreToolUse (TodoWrite)
+
+export SNIPARA_API_KEY="${answers.apiKey}"
+export SNIPARA_PROJECT_SLUG="${answers.projectSlug}"
+
+# Recall recent context on first TodoWrite
+if [ -z "$SNIPARA_SESSION_STARTED" ]; then
+  export SNIPARA_SESSION_STARTED=1
+
+  # Use snipara-mcp to recall context
+  if command -v snipara-mcp &> /dev/null; then
+    snipara-mcp recall --query "session progress recent work" --limit 3 2>/dev/null || true
+  fi
+fi
+
+exit 0
+`;
+}
+function createSessionHook(answers) {
+  return `#!/bin/bash
+# Snipara Session Hook - Auto-remembers significant commits
+# Event: PostToolUse (Bash)
+
+export SNIPARA_API_KEY="${answers.apiKey}"
+export SNIPARA_PROJECT_SLUG="${answers.projectSlug}"
+
+# Check if this was a git commit
+if echo "$TOOL_INPUT" | grep -q "git commit"; then
+  COMMIT_MSG=$(git log -1 --pretty=%B 2>/dev/null || echo "")
+
+  if [ -n "$COMMIT_MSG" ]; then
+    if command -v snipara-mcp &> /dev/null; then
+      snipara-mcp remember --type "context" --content "Committed: $COMMIT_MSG" --ttl 7 2>/dev/null || true
+    fi
+  fi
+fi
+
+exit 0
+`;
+}
+function createCompactHook(answers) {
+  return `#!/bin/bash
+# Snipara Compact Hook - Saves session context before compaction
+# Event: PreCompact
+
+export SNIPARA_API_KEY="${answers.apiKey}"
+export SNIPARA_PROJECT_SLUG="${answers.projectSlug}"
+
+# Save session context before compaction
+if command -v snipara-mcp &> /dev/null; then
+  # Extract key context from conversation (simplified)
+  snipara-mcp remember --type "context" --content "Session compacted. Resume point saved." --ttl 7 2>/dev/null || true
+fi
+
+exit 0
+`;
+}
+async function updateEnvFiles(answers) {
+  console.log(chalk.bold("\n\u{1F4DD} Updating Environment Files\n"));
+  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 = `
+# 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 (fs.existsSync(envExamplePath)) {
+    const content = fs.readFileSync(envExamplePath, "utf-8");
+    if (!content.includes("SNIPARA_API_KEY")) {
+      fs.appendFileSync(envExamplePath, `
+
+${envVars}
+`);
+      console.log(chalk.green("   \u2713 Updated .env.example"));
+    }
+  } else {
+    fs.writeFileSync(envExamplePath, envVars + "\n");
+    console.log(chalk.green("   \u2713 Created .env.example"));
+  }
+  const targetEnvPath = fs.existsSync(envLocalPath) ? envLocalPath : envPath;
+  if (fs.existsSync(targetEnvPath)) {
+    const content = fs.readFileSync(targetEnvPath, "utf-8");
+    if (!content.includes("SNIPARA_API_KEY") && !answers.apiKey.includes("YOUR_")) {
+      fs.appendFileSync(targetEnvPath, `
+
+${envVars}
+`);
+      console.log(chalk.green(`   \u2713 Updated ${path.basename(targetEnvPath)}`));
+    }
+  }
+}
+async function testConnection(answers) {
+  console.log(chalk.bold("\n\u{1F50C} Testing Connection\n"));
+  const spinner = ora("Connecting to Snipara API...").start();
+  try {
+    const response = await fetch(`${API_URL}/mcp/${answers.projectSlug}`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": answers.apiKey
+      },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: 1,
+        method: "tools/list",
+        params: {}
+      })
+    });
+    if (response.ok) {
+      const data = await response.json();
+      const toolCount = data.result?.tools?.length || 0;
+      spinner.succeed(`Connected! ${toolCount} MCP tools available.`);
+    } else {
+      const errorText = await response.text();
+      spinner.warn(`Connection returned ${response.status}: ${errorText}`);
+    }
+  } catch (error) {
+    spinner.warn(`Could not connect: ${error}`);
+    console.log(
+      chalk.dim(
+        "\n   This is normal if you haven't created the project yet."
+      )
+    );
+    console.log(chalk.dim(`   Create your project at: ${BASE_URL}/dashboard
+`));
+  }
+}
+function printSuccess(answers) {
+  console.log(
+    chalk.green(`
+\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
+\u2551                                                                       \u2551
+\u2551   ${chalk.bold("\u2713 Setup Complete!")}                                                 \u2551
+\u2551                                                                       \u2551
+\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+`)
+  );
+  console.log(chalk.bold("What was installed:\n"));
+  if (answers.installMcp) {
+    console.log(chalk.green("   \u2713 snipara-mcp") + chalk.dim(" - MCP server for context queries"));
+  }
+  if (answers.installRuntime) {
+    console.log(chalk.green("   \u2713 rlm-runtime") + chalk.dim(" - Safe code execution with Docker"));
+  }
+  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"));
+  console.log(chalk.bold("\nNext steps:\n"));
+  if (answers.apiKey.includes("YOUR_")) {
+    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");
+  } else {
+    console.log("  1. Restart your AI client (Claude Code, Cursor, etc.)");
+    console.log(`  2. Upload docs at ${chalk.cyan(`${BASE_URL}/dashboard`)}`);
+    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.dim(`
+  Docs: ${BASE_URL}/docs`));
+  console.log(chalk.dim("  Support: hello@snipara.com\n"));
+}
+function detectProjectSlug() {
+  try {
+    const remote = execSync("git remote get-url origin 2>/dev/null", {
+      encoding: "utf-8"
+    }).trim();
+    const match = remote.match(/[/:]([^/]+?)(?:\.git)?$/);
+    if (match) {
+      return match[1].toLowerCase().replace(/[^a-z0-9-]/g, "-");
+    }
+  } catch {
+  }
+  return path.basename(process.cwd()).toLowerCase().replace(/[^a-z0-9-]/g, "-");
+}
+function detectAiClient() {
+  if (fs.existsSync(path.join(homedir(), ".claude")) || process.env.CLAUDE_CODE) {
+    return "claude-code";
+  }
+  if (fs.existsSync(path.join(homedir(), ".cursor")) || process.env.CURSOR_EDITOR) {
+    return "cursor";
+  }
+  const claudeDesktopPath = process.platform === "darwin" ? path.join(homedir(), "Library", "Application Support", "Claude") : path.join(homedir(), "AppData", "Roaming", "Claude");
+  if (fs.existsSync(claudeDesktopPath)) {
+    return "claude-desktop";
+  }
+  return "other";
+}
+function detectPipCommand() {
+  const commands = ["uv", "pip3", "pip"];
+  for (const cmd of commands) {
+    try {
+      execSync(`${cmd} --version`, { stdio: "pipe" });
+      return cmd;
+    } catch {
+    }
+  }
+  return null;
+}
+function getExistingConfig() {
+  const mcpConfigPath = path.join(process.cwd(), ".mcp.json");
+  if (fs.existsSync(mcpConfigPath)) {
+    try {
+      const config = JSON.parse(fs.readFileSync(mcpConfigPath, "utf-8"));
+      const sniparaServer = config.mcpServers?.snipara;
+      if (sniparaServer?.url) {
+        const match = sniparaServer.url.match(/\/mcp\/([^/]+)$/);
+        return {
+          slug: match?.[1],
+          projectId: ""
+          // Could extract from headers if stored
+        };
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+main().catch((error) => {
+  console.error(chalk.red("Error:"), error.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "create-snipara",
+  "version": "1.0.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",
+  "bin": {
+    "create-snipara": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts --format esm --watch",
+    "prepublishOnly": "npm run build",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src --ext .ts"
+  },
+  "keywords": [
+    "snipara",
+    "create-snipara",
+    "mcp",
+    "rlm-runtime",
+    "context-optimization",
+    "llm",
+    "ai-agents",
+    "multi-agent",
+    "memory",
+    "claude-code",
+    "cursor",
+    "claude-desktop"
+  ],
+  "author": "Snipara",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Snipara/create-snipara.git"
+  },
+  "homepage": "https://snipara.com/docs/getting-started",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "ora": "^8.0.1",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.12",
+    "@types/prompts": "^2.4.9",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "eslint": "^8.57.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ]
+}