create-snipara 1.3.35 → 1.3.37

package/README.md

@@ -106,7 +106,8 @@ That distinction matters:
 - installs optional `snipara-orchestrator` for proof gates, drift checks, and htask workflows when requested
 - configures `.mcp.json`
 - generates merge-ready AI agent templates in `.snipara/templates/`, including Pro+ symbol-card, code-impact, and managed workflow guidance for paid Context plans
-- creates `AGENTS.md`, `CLAUDE.md`, `.cursor/rules/snipara.mdc`, and `.codex/config.toml` when those files do not already exist
+- creates `AGENTS.md` and `CLAUDE.md` when missing, or appends a marked Snipara section when those files already exist
+- creates `.cursor/rules/snipara.mdc` and `.codex/config.toml` when those files do not already exist
 - writes client-specific companion packs such as `.snipara/companion/CODEX.md` or `.snipara/companion/GEMINI.md`
 - updates `.env`, `.env.local`, and `.env.example`
 - generates `.snipara/companion/README.md`
@@ -162,6 +163,10 @@ The generated agent templates cover:
 - ChatGPT/OpenAI HTTP MCP snippet
 - Gemini, VS Code, Continue, and custom HTTP MCP reference snippets
 
+Existing root `AGENTS.md` and `CLAUDE.md` files are not replaced. The installer
+adds or refreshes a marked Snipara section so project-specific instructions stay
+intact.
+
 When `snipara-companion` is installed, the companion pack also includes the compaction-safe managed workflow:
 
 ```bash

package/dist/index.js

@@ -13,7 +13,7 @@ import { homedir } from "os";
 // package.json
 var package_default = {
   name: "create-snipara",
-  version: "1.3.35",
+  version: "1.3.37",
   description: "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   main: "dist/index.js",
   type: "module",
@@ -163,10 +163,19 @@ function getCompanionInitClientFlag(aiClient) {
   const companionClient = supportedClientMap[aiClient];
   return companionClient ? ` --client ${companionClient}` : "";
 }
+function getAutomationClientId(aiClient) {
+  if (aiClient === "other" || aiClient === "claude-desktop") {
+    return "custom";
+  }
+  return aiClient;
+}
 function buildProgram() {
   const program = new Command();
   program.name("create-snipara").description("Scaffold hosted Snipara MCP config plus companion workflow helpers").version(VERSION);
-  program.command("init").description("Install and configure Snipara for this project").option("--api-key <key>", "Snipara API key").option("--slug <slug>", "Project slug").option("--project-id <id>", "Project ID").option("--advanced", "Show advanced profile, project id, hooks, GitHub, and sandbox prompts").option(
+  program.command("init").description("Install and configure Snipara for this project").option("--api-key <key>", "Snipara API key").option("--slug <slug>", "Project slug").option("--project-id <id>", "Project ID").option(
+    "--client <client>",
+    "AI client: claude-code, cursor, windsurf, codex, gemini, chatgpt, vscode, continue, claude-desktop, other"
+  ).option("--advanced", "Show advanced profile, project id, hooks, GitHub, and sandbox prompts").option(
     "--profile <profile>",
     "Install profile: hosted-only, hosted-companion, full-stack, runtime-only"
   ).option("--skip-companion", "Skip local companion CLI installation").option("--skip-mcp", "Skip local snipara-mcp package installation").option("--skip-runtime", "Skip snipara-sandbox installation").option("--skip-hooks", "Skip hook generation").option("--skip-test", "Skip hosted connection test").option("--with-orchestrator", "Install optional snipara-orchestrator package").option("--github", "Open GitHub repository automation setup when a git remote is detected").option("--skip-github", "Skip the GitHub automation prompt").option("--github-path <path>", "Optional GitHub path filter for the initial repository sync").option("--runtime-only", "Install only Snipara Sandbox").addOption(new Option("--full", "Legacy alias for --profile full-stack").hideHelp()).option("-y, --yes", "Accept defaults without prompting").action(async (options) => {
@@ -200,7 +209,10 @@ function buildProgram() {
   return program;
 }
 function addSharedRootOptions(program) {
-  program.option("--api-key <key>", "Snipara API key").option("--slug <slug>", "Project slug").option("--project-id <id>", "Project ID").option("--advanced", "Show advanced profile, project id, hooks, GitHub, and sandbox prompts").option(
+  program.option("--api-key <key>", "Snipara API key").option("--slug <slug>", "Project slug").option("--project-id <id>", "Project ID").option(
+    "--client <client>",
+    "AI client: claude-code, cursor, windsurf, codex, gemini, chatgpt, vscode, continue, claude-desktop, other"
+  ).option("--advanced", "Show advanced profile, project id, hooks, GitHub, and sandbox prompts").option(
     "--profile <profile>",
     "Install profile: hosted-only, hosted-companion, full-stack, runtime-only"
   ).option("--skip-companion", "Skip local companion CLI installation").option("--skip-mcp", "Skip local snipara-mcp package installation").option("--skip-runtime", "Skip snipara-sandbox installation").option("--skip-hooks", "Skip hook generation").option("--skip-test", "Skip hosted connection test").option("--with-orchestrator", "Install optional snipara-orchestrator package").option("--github", "Open GitHub repository automation setup when a git remote is detected").option("--skip-github", "Skip the GitHub automation prompt").option("--github-path <path>", "Optional GitHub path filter for the initial repository sync").option("--runtime-only", "Install only Snipara Sandbox").addOption(new Option("--full", "Legacy alias for --profile full-stack").hideHelp()).option("-y, --yes", "Accept defaults without prompting");
@@ -233,6 +245,7 @@ function parseInitOptionsFromArgv(args) {
     "--api-key": "apiKey",
     "--slug": "slug",
     "--project-id": "projectId",
+    "--client": "client",
     "--profile": "profile",
     "--github-path": "githubPath"
   };
@@ -285,6 +298,9 @@ async function runInit(options) {
   if (answers.profile !== "runtime-only" || answers.installRuntime) {
     await createMcpConfig(answers);
   }
+  if (answers.aiClient === "claude-code" && answers.profile !== "runtime-only") {
+    await createClaudeCodeConfig(answers);
+  }
   await createProjectBinding(answers);
   await createAgentTemplates(answers);
   if (answers.installHooks && answers.aiClient === "claude-code") {
@@ -292,6 +308,7 @@ async function runInit(options) {
   }
   await updateEnvFiles(answers);
   await createCompanionConfig(answers);
+  await syncRemoteAutomationClient(answers, { enabled: !options.skipTest });
   await createCompanionPack(answers);
   const validationReport = await runValidation(answers, !options.skipTest);
   writeDoctorReport(validationReport);
@@ -331,6 +348,9 @@ async function runRepair(options) {
     await installNodeCompanion(true);
   }
   await createMcpConfig(answers);
+  if (answers.aiClient === "claude-code" && answers.profile !== "runtime-only") {
+    await createClaudeCodeConfig(answers);
+  }
   await createProjectBinding(answers);
   await createAgentTemplates(answers);
   await updateEnvFiles(answers);
@@ -362,6 +382,9 @@ async function runUpgrade(options) {
   if (options.withMcp || options.withRuntime || detection.files.mcpConfig) {
     await createMcpConfig(upgradedAnswers);
   }
+  if (upgradedAnswers.aiClient === "claude-code" && upgradedAnswers.profile !== "runtime-only") {
+    await createClaudeCodeConfig(upgradedAnswers);
+  }
   await createProjectBinding(upgradedAnswers);
   await createAgentTemplates(upgradedAnswers);
   await createCompanionConfig(upgradedAnswers);
@@ -445,6 +468,7 @@ function printBanner() {
 async function gatherConfiguration(options) {
   console.log(chalk.bold("\n\u{1F4CB} Project Configuration\n"));
   const detectedClient = detectAiClient();
+  const requestedClient = normalizeClientOption(options.client);
   const existingConfig = getExistingConfig();
   const projectSlugResolution = resolveProjectSlug(existingConfig);
   let detectedSlug = projectSlugResolution.slug;
@@ -477,7 +501,7 @@ async function gatherConfiguration(options) {
       apiKey: providedApiKey || "YOUR_API_KEY_HERE",
       apiKeyType: providedApiKey ? "api" : "none",
       profile: initialProfile,
-      aiClient: detectedClient,
+      aiClient: requestedClient || detectedClient,
       skipCompanion: !!options.skipCompanion,
       skipMcp: !!options.skipMcp,
       skipRuntime: !!options.skipRuntime,
@@ -544,7 +568,9 @@ async function gatherConfiguration(options) {
       message: "Which AI client are you using?",
       initial: Math.max(
         0,
-        AI_CLIENT_CHOICES.findIndex((choice) => choice.value === detectedClient)
+        AI_CLIENT_CHOICES.findIndex(
+          (choice) => choice.value === (requestedClient || detectedClient)
+        )
       ),
       choices: AI_CLIENT_CHOICES
     },
@@ -595,7 +621,7 @@ async function gatherConfiguration(options) {
     apiKey: apiKey || "",
     apiKeyType,
     profile: response.profile || initialProfile,
-    aiClient: response.aiClient || detectedClient,
+    aiClient: requestedClient || response.aiClient || detectedClient,
     skipCompanion: !!options.skipCompanion,
     skipMcp: !!options.skipMcp,
     skipRuntime: !!options.skipRuntime,
@@ -693,7 +719,8 @@ function normalizeClientOption(value) {
     chatgpt: "chatgpt",
     vscode: "vscode",
     continue: "continue",
-    other: "other"
+    other: "other",
+    custom: "other"
   };
   const client = aliases[normalized];
   if (!client) {
@@ -861,10 +888,14 @@ async function runDeviceAuthorization() {
   spinner.fail("Authorization expired");
   throw new Error("device code expired");
 }
-async function postJson(url, body, allowErrorResponse = false) {
+async function postJson(url, body, allowErrorResponse = false, init = {}) {
+  const headers = {
+    ...init.headers ?? {},
+    "Content-Type": "application/json"
+  };
   const response = await fetch(url, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
+    method: init.method ?? "POST",
+    headers,
     body: JSON.stringify(body)
   });
   const data = await response.json().catch(() => ({}));
@@ -1070,13 +1101,7 @@ async function createMcpConfig(answers) {
     }
   }
   if (answers.profile !== "runtime-only") {
-    mcpConfig.mcpServers.snipara = {
-      type: "http",
-      url: `${API_URL}/mcp/${answers.projectSlug}`,
-      headers: {
-        "X-API-Key": answers.apiKey || "YOUR_API_KEY_HERE"
-      }
-    };
+    mcpConfig.mcpServers.snipara = buildHostedMcpServer(answers);
   }
   if (answers.installRuntime) {
     mcpConfig.mcpServers[SANDBOX_SERVER_NAME] = {
@@ -1096,6 +1121,48 @@ async function createMcpConfig(answers) {
     await createClaudeDesktopConfig(answers);
   }
 }
+function buildHostedMcpServer(answers) {
+  return {
+    type: "http",
+    url: buildHostedMcpEndpoint(answers),
+    headers: {
+      "X-API-Key": answers.apiKey || "YOUR_API_KEY_HERE"
+    }
+  };
+}
+function asObjectRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+async function createClaudeCodeConfig(answers) {
+  if (answers.profile === "runtime-only") {
+    return;
+  }
+  const claudeDir = path.join(homedir(), ".claude");
+  const settingsPath = path.join(claudeDir, "settings.json");
+  console.log(chalk.bold("\n\u{1F916} Configuring Claude Code MCP\n"));
+  try {
+    fs.mkdirSync(claudeDir, { recursive: true });
+    let settings = {};
+    if (fs.existsSync(settingsPath)) {
+      settings = asObjectRecord(JSON.parse(fs.readFileSync(settingsPath, "utf-8")));
+    }
+    const mcpServers = asObjectRecord(settings.mcpServers);
+    settings.mcpServers = {
+      ...mcpServers,
+      snipara: buildHostedMcpServer(answers)
+    };
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", { mode: 384 });
+    try {
+      fs.chmodSync(settingsPath, 384);
+    } catch {
+    }
+    console.log(chalk.green("   \u2713 Updated ~/.claude/settings.json with Snipara MCP"));
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    console.log(chalk.yellow(`   \u26A0\uFE0F  Could not update Claude Code MCP config: ${detail}`));
+    console.log(chalk.dim("   Run create-snipara doctor --client claude after manual setup."));
+  }
+}
 async function createProjectBinding(answers) {
   if (answers.profile === "runtime-only") {
     return;
@@ -1383,13 +1450,7 @@ async function createClaudeDesktopConfig(answers) {
       config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
     }
     config.mcpServers = config.mcpServers || {};
-    config.mcpServers.snipara = {
-      type: "http",
-      url: buildHostedMcpEndpoint(answers),
-      headers: {
-        "X-API-Key": answers.apiKey
-      }
-    };
+    config.mcpServers.snipara = buildHostedMcpServer(answers);
     if (answers.installRuntime) {
       config.mcpServers[SANDBOX_SERVER_NAME] = {
         command: detectSandboxCommand() || SANDBOX_COMMAND_NAME,
@@ -1640,31 +1701,49 @@ async function createCompanionConfig(answers) {
   }
   const configDir = path.join(process.cwd(), ".snipara", "companion");
   const configPath = path.join(configDir, "config.json");
-  const globalConfigPath = getGlobalCompanionConfigPath();
   fs.mkdirSync(configDir, { recursive: true });
-  fs.mkdirSync(path.dirname(globalConfigPath), { recursive: true });
-  const existingGlobalConfig = readCompanionConfigFile(globalConfigPath);
   const existingWorkspaceConfig = readCompanionConfigFile(configPath);
-  const globalConfig = {
-    ...existingGlobalConfig,
-    apiKey: answers.apiKey,
-    apiUrl: API_URL
-  };
   const workspaceConfig = {
-    projectId: answers.projectSlug,
-    sessionId: typeof existingWorkspaceConfig.sessionId === "string" && existingWorkspaceConfig.sessionId ? existingWorkspaceConfig.sessionId : `sess_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`
+    ...existingWorkspaceConfig,
+    apiKey: answers.apiKey,
+    apiUrl: API_URL,
+    projectId: answers.projectId || answers.projectSlug,
+    sessionId: typeof existingWorkspaceConfig.sessionId === "string" && existingWorkspaceConfig.sessionId ? existingWorkspaceConfig.sessionId : `sess_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+    client: getAutomationClientId(answers.aiClient)
   };
-  fs.writeFileSync(globalConfigPath, JSON.stringify(globalConfig, null, 2) + "\n");
   fs.writeFileSync(configPath, JSON.stringify(workspaceConfig, null, 2) + "\n");
-  ensureGitignoreEntry(
-    ".snipara/companion/config.json",
-    "# Snipara local companion workspace config"
-  );
-  console.log(chalk.green("   \u2713 Configured global companion auth"));
-  console.log(chalk.green("   \u2713 Configured local companion workspace"));
+  ensureGitignoreEntry(".snipara/companion/config.json", "# Snipara local companion config");
+  console.log(chalk.green("   \u2713 Configured local companion config"));
 }
-function getGlobalCompanionConfigPath() {
-  return path.join(homedir(), ".rlmsaas", "config.json");
+async function syncRemoteAutomationClient(answers, options) {
+  if (!options.enabled || answers.apiKeyType === "none" || !answers.apiKey || answers.apiKey.includes("YOUR_") || !answers.projectSlug) {
+    return;
+  }
+  const automationClient = getAutomationClientId(answers.aiClient);
+  const url = `${BASE_URL}/api/cli/projects/${encodeURIComponent(
+    answers.projectSlug
+  )}/automation-client`;
+  try {
+    const response = await postJson(
+      url,
+      { automationClient },
+      false,
+      {
+        method: "PATCH",
+        headers: { "X-API-Key": answers.apiKey }
+      }
+    );
+    if (response.success === false) {
+      throw new Error(response.message || "dashboard rejected automation client update");
+    }
+    console.log(chalk.green(`   \u2713 Synced dashboard automation client: ${automationClient}`));
+  } catch (error) {
+    console.log(
+      chalk.yellow(
+        `   \u26A0\uFE0F  Could not sync dashboard automation client: ${error instanceof Error ? error.message : "unknown error"}`
+      )
+    );
+  }
 }
 function readCompanionConfigFile(filePath) {
   if (!fs.existsSync(filePath)) {
@@ -1899,7 +1978,7 @@ function getClientPackFilename(client) {
 }
 function getClientConfigArtifacts(client) {
   if (client === "claude-code") {
-    return ["AGENTS.md", "CLAUDE.md", ".claude/settings.json when hooks are installed"];
+    return ["AGENTS.md", "CLAUDE.md", "~/.claude/settings.json MCP server"];
   }
   if (client === "cursor") {
     return [".mcp.json", ".cursor/rules/snipara.mdc", "dashboard automation bundle when installed"];
@@ -2172,7 +2251,7 @@ function getClaudeClientChecks(answers, detection) {
     checks.push({
       name: "claude_code_settings",
       status: detection.files.claudeSettings ? codeSettingsHasSnipara ? "pass" : "warn" : "warn",
-      detail: detection.files.claudeSettings ? codeSettingsHasSnipara ? "~/.claude/settings.json references Snipara" : "~/.claude/settings.json exists but no Snipara MCP server was found" : "~/.claude/settings.json not found; Claude may require Settings -> MCP UI setup"
+      detail: detection.files.claudeSettings ? codeSettingsHasSnipara ? "~/.claude/settings.json contains a Snipara MCP server" : "~/.claude/settings.json exists but no Snipara MCP server was found" : "~/.claude/settings.json not found; Claude may require Settings -> MCP UI setup"
     });
   }
   if (answers.aiClient === "claude-desktop") {
@@ -2598,6 +2677,11 @@ function printSuccess(answers, report) {
   if (answers.profile !== "runtime-only") {
     console.log(chalk.green("   \u2713 .mcp.json") + chalk.dim(" - Hosted MCP config"));
   }
+  if (answers.aiClient === "claude-code" && answers.profile !== "runtime-only") {
+    console.log(
+      chalk.green("   \u2713 ~/.claude/settings.json") + chalk.dim(" - Claude Code Hosted MCP server")
+    );
+  }
   console.log(chalk.green("   \u2713 .snipara/companion") + chalk.dim(" - Local pack + doctor report"));
   const failedChecks = report.checks.filter((check) => check.status === "fail");
   const warnedChecks = report.checks.filter((check) => check.status === "warn");
@@ -2610,7 +2694,7 @@ function printSuccess(answers, report) {
   printNextStep("Restart your AI client if you created or changed hosted MCP config.");
   if (answers.aiClient === "claude-code") {
     printNextStep(
-      "For Claude Code, confirm Snipara appears in Settings -> MCP or ToolSearch; local files alone do not prove Claude loaded the server."
+      "For Claude Code, start a new session and confirm Snipara appears in Settings -> MCP or ToolSearch."
     );
     printNextStep("If Snipara tools are missing, run: npx create-snipara doctor --client claude");
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-snipara",
-  "version": "1.3.35",
+  "version": "1.3.37",
   "description": "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   "main": "dist/index.js",
   "type": "module",