create-snipara 1.1.0 → 1.2.0

package/README.md

@@ -26,29 +26,59 @@ You'll be prompted for:
 |--------|-------------|
 | **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) |
+| **API key type** | Project key, Team key, Sign up, or Skip |
+| **API key** | Your Snipara API key |
 | **AI client** | Claude Code, Cursor, Claude Desktop, or other |
 | **Packages** | Choose what to install |
+| **LLM provider** | OpenAI, Anthropic, or None (for `rlm run`/`rlm agent` CLI) |
+| **Run rlm init** | Optional - configure execution environment (sandbox/docker/local) |
+
+## API Key Requirements
+
+| Tool | Snipara API Key | LLM API Key (OpenAI/Anthropic) |
+|------|-----------------|-------------------------------|
+| `execute_python` MCP | Not needed | Not needed (your AI client is the LLM) |
+| `rlm_context_query` MCP | **Required** | Not needed |
+| `rlm_remember`/`rlm_recall` | **Required** | Not needed |
+| `rlm run` / `rlm agent` CLI | Optional (for context) | **Required** |
+
+### Key Types
+
+| Type | Description |
+|------|-------------|
+| **Project API key** | Access to a single project |
+| **Team API key** | Access to all projects in your team |
 
 ## Command Line Options
 
 ```bash
-# Use existing API key
-npx create-snipara --api-key rlm_your_key_here
+# Basic usage
+npx create-snipara
+
+# With project API key
+npx create-snipara --api-key rlm_your_project_key
+
+# With team API key (access all team projects)
+npx create-snipara --team-key rlm_your_team_key
 
 # Specify project slug
 npx create-snipara --slug my-project
 
+# Runtime only - no Snipara API key needed
+# (for execute_python MCP tool only)
+npx create-snipara --runtime-only
+
 # 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
+npx create-snipara --skip-test     # Skip connection test
 
-# Accept all defaults
-npx create-snipara -y
+# Accept all defaults (non-interactive)
+npx create-snipara -y --api-key rlm_xxx --slug my-project
 
-# Full example
-npx create-snipara --api-key rlm_xxx --slug my-project --skip-hooks
+# Full example with team key
+npx create-snipara --team-key rlm_team_xxx --slug my-project --skip-hooks
 ```
 
 ## What Gets Created
@@ -85,8 +115,14 @@ npx create-snipara --api-key rlm_xxx --slug my-project --skip-hooks
 Updates `.env.example` and `.env.local` with:
 
 ```bash
+# Snipara Configuration
 SNIPARA_API_KEY=your_api_key
 SNIPARA_PROJECT_SLUG=your-project
+
+# RLM-Runtime LLM Provider (if configured)
+OPENAI_API_KEY=sk-...
+# or
+ANTHROPIC_API_KEY=sk-ant-...
 ```
 
 ## After Installation
@@ -101,12 +137,48 @@ SNIPARA_PROJECT_SLUG=your-project
 1. Restart Claude Desktop
 2. Config is at `~/Library/Application Support/Claude/claude_desktop_config.json`
 
-### RLM-Runtime Commands
+### RLM-Runtime Usage
+
+**MCP Tools (no LLM API key needed):**
+
+Your AI client (Claude, GPT, etc.) provides the LLM - no additional API key required.
+
+```
+• execute_python    - Run Python in sandbox
+• get_repl_context  - Get session variables
+• set_repl_context  - Set session variables
+• clear_repl_context - Clear session
+```
+
+**Execution Environments:**
+
+| Environment | Description | Use Case |
+|-------------|-------------|----------|
+| **sandbox** | RestrictedPython, safe stdlib only | Default, most secure |
+| **docker** | Full Python in isolated container | Recommended for full features |
+| **local** | Full access, no isolation | Development only |
+
+During setup, you can run `rlm init` to configure the default environment.
+Or configure later:
 
 ```bash
+rlm init  # Interactive configuration
+```
+
+**CLI Commands (requires LLM API key):**
+
+For `rlm run` and `rlm agent`, you need an LLM provider API key:
+
+```bash
+# Set your LLM provider
+export OPENAI_API_KEY=sk-...
+# or
+export ANTHROPIC_API_KEY=sk-ant-...
+
+# Run commands
 rlm init              # Initialize configuration
 rlm run --env docker  # Run with Docker isolation
-rlm serve             # Start MCP server
+rlm agent "task"      # Autonomous agent mode
 rlm visualize         # Launch trajectory dashboard
 ```
 
@@ -119,7 +191,7 @@ After setup, you have access to 43+ MCP 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) |
+| **Execution** | `execute_python`, `get_repl_context` (via RLM-Runtime) |
 | **Swarms** | `rlm_swarm_create`, `rlm_claim`, `rlm_task_create` |
 
 ## Requirements
@@ -133,7 +205,8 @@ After setup, you have access to 43+ MCP tools:
 - **Website**: https://snipara.com
 - **Documentation**: https://snipara.com/docs
 - **Dashboard**: https://snipara.com/dashboard
-- **Support**: hello@snipara.com
+- **npm**: https://www.npmjs.com/package/create-snipara
+- **Support**: hello@starbox-group.com
 
 ## License
 

package/dist/index.js

@@ -7,9 +7,9 @@ import chalk from "chalk";
 import ora from "ora";
 import fs from "fs";
 import path from "path";
-import { execSync } from "child_process";
+import { execSync, spawn } from "child_process";
 import { homedir } from "os";
-var VERSION = "1.1.0";
+var VERSION = "1.2.0";
 var BASE_URL = "https://www.snipara.com";
 var API_URL = "https://api.snipara.com";
 async function main() {
@@ -29,6 +29,9 @@ async function main() {
     await testConnection(answers);
   }
   printSuccess(answers);
+  if (answers.runRlmInit && answers.installRuntime) {
+    await runRlmInit();
+  }
 }
 function printBanner() {
   console.log(
@@ -247,6 +250,20 @@ async function gatherConfiguration(options) {
     llmProvider = llmResponse.llmProvider;
     llmApiKey = llmResponse.llmApiKey;
   }
+  let runRlmInit2 = false;
+  if (packages.includes("runtime")) {
+    console.log(chalk.cyan("\n   \u2139\uFE0F  RLM-Runtime Execution Environments:\n"));
+    console.log(chalk.dim("   \u2022 sandbox - RestrictedPython, safe stdlib only (default)"));
+    console.log(chalk.dim("   \u2022 docker  - Full Python in isolated container (recommended)"));
+    console.log(chalk.dim("   \u2022 local   - Full access, no isolation (development only)\n"));
+    const initResponse = await prompts({
+      type: "confirm",
+      name: "runRlmInit",
+      message: "Run 'rlm init' now to configure execution environment?",
+      initial: false
+    });
+    runRlmInit2 = initResponse.runRlmInit || false;
+  }
   return {
     projectSlug: response.projectSlug,
     projectId: response.projectId || "",
@@ -257,7 +274,8 @@ async function gatherConfiguration(options) {
     installHooks: packages.includes("hooks"),
     aiClient: response.aiClient || detectedClient,
     llmProvider,
-    llmApiKey
+    llmApiKey,
+    runRlmInit: runRlmInit2
   };
 }
 async function handleSignup() {
@@ -610,6 +628,32 @@ ${envVars}
     }
   }
 }
+async function runRlmInit() {
+  console.log(chalk.bold("\n\u{1F527} Running RLM-Runtime Configuration\n"));
+  console.log(chalk.dim("   Starting 'rlm init' - follow the prompts to configure execution environment...\n"));
+  return new Promise((resolve) => {
+    const child = spawn("rlm", ["init"], {
+      stdio: "inherit",
+      shell: true
+    });
+    child.on("close", (code) => {
+      if (code === 0) {
+        console.log(chalk.green("\n   \u2713 RLM-Runtime configured successfully"));
+      } else if (code !== null) {
+        console.log(chalk.yellow(`
+   \u26A0\uFE0F  rlm init exited with code ${code}`));
+        console.log(chalk.dim("   You can run 'rlm init' manually later to configure execution environment."));
+      }
+      resolve();
+    });
+    child.on("error", (error) => {
+      console.log(chalk.yellow(`
+   \u26A0\uFE0F  Could not run rlm init: ${error.message}`));
+      console.log(chalk.dim("   Run 'rlm init' manually after installation completes."));
+      resolve();
+    });
+  });
+}
 async function testConnection(answers) {
   console.log(chalk.bold("\n\u{1F50C} Testing Connection\n"));
   const spinner = ora("Connecting to Snipara API...").start();
@@ -708,10 +752,14 @@ function printSuccess(answers) {
       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"));
     }
+    if (!answers.runRlmInit) {
+      console.log(chalk.dim("\n   To configure execution environment (sandbox/docker/local):"));
+      console.log(chalk.cyan("     rlm init"));
+    }
   }
   console.log(chalk.dim(`
   Docs: ${BASE_URL}/docs`));
-  console.log(chalk.dim("  Support: hello@snipara.com\n"));
+  console.log(chalk.dim("  Support: hello@starbox-group.com\n"));
 }
 function detectProjectSlug() {
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-snipara",
-  "version": "1.1.0",
+  "version": "1.2.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",