create-snipara 1.3.16 → 1.3.17

package/README.md

@@ -16,7 +16,7 @@ so an LLM client can use Snipara context and reviewed memory.
 
 Use it for:
 
-- Hosted MCP onboarding for Codex, Claude Code, Cursor, ChatGPT Desktop, and similar clients
+- Hosted MCP onboarding for Claude Code, Cursor, Windsurf, Codex, Gemini, VS Code/Copilot, Continue, ChatGPT Desktop, and similar clients
 - free account signup with reviewed Context + Memory
 - local project wiring, `doctor`, `repair`, and `upgrade`
 - GitHub repository sync and PR Answer Packs approval when the current folder is a GitHub repo
@@ -32,8 +32,8 @@ flowchart LR
     Project["Local project"] --> CLI["npx create-snipara"]
     CLI --> Auth["Snipara auth and project key"]
     CLI --> MCP["Hosted MCP config"]
-    CLI --> Templates["AGENTS.md, CLAUDE.md, Cursor, Codex snippets"]
-    MCP --> Agents["Codex, Claude Code, Cursor, ChatGPT Desktop"]
+    CLI --> Templates["AGENTS.md, CLAUDE.md, Cursor, Codex, MCP references"]
+    MCP --> Agents["Claude Code, Cursor, Codex, Gemini, VS Code, ChatGPT"]
     Templates --> Agents
     Agents --> Context["Snipara context and memory"]
 ```
@@ -74,7 +74,7 @@ Free onboarding is now **Context + Memory**, not Context-only:
 
 - Context Free: three projects and 1,000 context queries/month
 - Memory Free: reviewed hosted memories for continuity across sessions
-- Hosted MCP: direct connection for Claude Code, Codex, Cursor, ChatGPT Desktop, and other MCP clients
+- Hosted MCP: direct connection for Claude Code, Cursor, Windsurf, Codex, Gemini, VS Code/Copilot, Continue, ChatGPT Desktop, and other MCP clients
 
 The CLI opens a browser device-flow login when the user does not already have a key, auto-provisions the free Context + Memory account when needed, then writes the returned API key into the local MCP config.
 
@@ -105,6 +105,7 @@ That distinction matters:
 - 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
+- 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`
 - generates `.snipara/companion/commands.json`
@@ -155,6 +156,7 @@ The generated agent templates cover:
 - Cursor `.cursor/rules/snipara.mdc`
 - Codex `.codex/config.toml` snippet
 - ChatGPT/OpenAI HTTP MCP snippet
+- Gemini, VS Code, Continue, and custom HTTP MCP reference snippets
 
 When `snipara-companion` is installed, the companion pack also includes the compaction-safe managed workflow:
 
@@ -297,18 +299,22 @@ The intended split is:
 - `snipara-mcp`: local stdio bridge, client-package development, compatibility, and testing
 - `snipara-sandbox`: optional local execution engine
 
-## Codex Setup
+## Client Packs
 
-For Codex, keep Hosted MCP as the core path and let companion add workflow
-ergonomics:
+For every selected AI client, keep Hosted MCP as the core path and let
+companion add workflow ergonomics:
 
 - use Hosted MCP as the core Snipara surface
 - use `AGENTS.md` for project instructions
+- use the selected pack under `.snipara/companion/`, for example `CODEX.md`, `CURSOR.md`, or `GEMINI.md`
 - use the default `hosted-companion` path when you want compaction-safe local phase commits
 - choose `hosted-only` or `--skip-companion` only in locked-down environments
 - use local `snipara-mcp` only for stdio compatibility, development, or tests
 
-Codex does not require hook presets to use Snipara successfully.
+Claude Code, Cursor, and Windsurf can receive generated automation files when
+that client has a useful local hook surface. Codex, Gemini, VS Code, Continue,
+ChatGPT, and custom clients are treated as MCP-first: they get the hosted MCP
+configuration/reference and agent instructions, not invented local hooks.
 
 This keeps setup and runtime separated while still giving the user one obvious command to start from.
 
@@ -317,6 +323,7 @@ This keeps setup and runtime separated while still giving the user one obvious c
 After setup, the project gets a local pack at `.snipara/companion/`:
 
 - `README.md`: local usage guidance
+- `<CLIENT>.md`: selected client setup overlay, such as `CODEX.md` or `GEMINI.md`
 - `commands.json`: starter commands for the current project
 - `doctor.json`: most recent validation report
 

package/dist/index.js

@@ -9,7 +9,7 @@ import fs from "fs";
 import path from "path";
 import { execSync, spawn } from "child_process";
 import { homedir } from "os";
-var VERSION = "1.3.15";
+var VERSION = "1.3.17";
 var BASE_URL = "https://www.snipara.com";
 var API_URL = "https://api.snipara.com";
 var COMPANION_PACKAGE_NAME = "snipara-companion";
@@ -25,11 +25,68 @@ var LEGACY_SANDBOX_COMMAND_NAME = "rlm";
 var DEVICE_CLIENT_ID = "create-snipara";
 var DeviceAuthorizationAborted = class extends Error {
 };
+var AI_CLIENT_CHOICES = [
+  {
+    title: "Claude Code (CLI/VS Code extension)",
+    value: "claude-code",
+    description: "Best hooks support"
+  },
+  {
+    title: "Cursor",
+    value: "cursor",
+    description: "Hosted MCP plus Cursor rules and automation bundles"
+  },
+  {
+    title: "Windsurf",
+    value: "windsurf",
+    description: "Hosted MCP plus Windsurf automation bundles"
+  },
+  {
+    title: "OpenAI Codex",
+    value: "codex",
+    description: "Hosted MCP plus AGENTS.md and Codex config"
+  },
+  {
+    title: "Gemini CLI",
+    value: "gemini",
+    description: "Hosted MCP reference plus agent instructions"
+  },
+  {
+    title: "VS Code / Copilot",
+    value: "vscode",
+    description: "Hosted MCP reference for VS Code-compatible clients"
+  },
+  {
+    title: "Continue",
+    value: "continue",
+    description: "Hosted MCP reference for Continue"
+  },
+  {
+    title: "ChatGPT / OpenAI MCP",
+    value: "chatgpt",
+    description: "Hosted MCP for ChatGPT Desktop or OpenAI-compatible clients"
+  },
+  {
+    title: "Claude Desktop",
+    value: "claude-desktop",
+    description: "Desktop MCP config flow"
+  },
+  { title: "Other MCP client", value: "other" }
+];
 function getCompanionInitClientFlag(aiClient) {
-  if (aiClient === "cursor") {
-    return " --client cursor";
-  }
-  return aiClient === "claude-code" ? " --client claude-code" : "";
+  const supportedClientMap = {
+    "claude-code": "claude-code",
+    cursor: "cursor",
+    windsurf: "windsurf",
+    codex: "codex",
+    gemini: "gemini",
+    chatgpt: "chatgpt",
+    vscode: "vscode",
+    continue: "continue",
+    other: "custom"
+  };
+  const companionClient = supportedClientMap[aiClient];
+  return companionClient ? ` --client ${companionClient}` : "";
 }
 function buildProgram() {
   const program = new Command();
@@ -363,37 +420,11 @@ async function gatherConfiguration(options) {
       type: "select",
       name: "aiClient",
       message: "Which AI client are you using?",
-      initial: ["claude-code", "cursor", "codex", "chatgpt", "claude-desktop", "other"].indexOf(
-        detectedClient
+      initial: Math.max(
+        0,
+        AI_CLIENT_CHOICES.findIndex((choice) => choice.value === detectedClient)
       ),
-      choices: [
-        {
-          title: "Claude Code (CLI/VS Code extension)",
-          value: "claude-code",
-          description: "Best hooks support"
-        },
-        {
-          title: "Cursor",
-          value: "cursor",
-          description: "MCP via .mcp.json plus companion terminal workflows"
-        },
-        {
-          title: "OpenAI Codex",
-          value: "codex",
-          description: "Hosted MCP plus AGENTS.md"
-        },
-        {
-          title: "ChatGPT / OpenAI MCP",
-          value: "chatgpt",
-          description: "Hosted MCP for ChatGPT Desktop or OpenAI-compatible clients"
-        },
-        {
-          title: "Claude Desktop",
-          value: "claude-desktop",
-          description: "Desktop MCP config flow"
-        },
-        { title: "Other", value: "other" }
-      ]
+      choices: AI_CLIENT_CHOICES
     },
     {
       type: showAdvancedPrompts ? "confirm" : null,
@@ -906,6 +937,22 @@ async function createAgentTemplates(answers) {
     {
       path: path.join(templatesDir, "chatgpt-openai-mcp.json"),
       content: buildChatGptMcpTemplate(answers)
+    },
+    {
+      path: path.join(templatesDir, "gemini-mcp-reference.json"),
+      content: buildGenericMcpReferenceTemplate(answers, "gemini")
+    },
+    {
+      path: path.join(templatesDir, "vscode-mcp-reference.json"),
+      content: buildGenericMcpReferenceTemplate(answers, "vscode")
+    },
+    {
+      path: path.join(templatesDir, "continue-mcp-reference.json"),
+      content: buildGenericMcpReferenceTemplate(answers, "continue")
+    },
+    {
+      path: path.join(templatesDir, "custom-mcp-reference.json"),
+      content: buildGenericMcpReferenceTemplate(answers, "custom")
     }
   ];
   for (const template of templates) {
@@ -1054,6 +1101,26 @@ function buildChatGptMcpTemplate(answers) {
   )}
 `;
 }
+function buildGenericMcpReferenceTemplate(answers, client) {
+  return `${JSON.stringify(
+    {
+      client,
+      note: "Reference format only; paste the server fields into this client's MCP settings.",
+      mcpServers: {
+        snipara: {
+          type: "http",
+          url: buildHostedMcpEndpoint(answers),
+          headers: {
+            "X-API-Key": "${SNIPARA_API_KEY}"
+          }
+        }
+      }
+    },
+    null,
+    2
+  )}
+`;
+}
 function ensureGitignoreEntry(entry, comment) {
   const gitignorePath = path.join(process.cwd(), ".gitignore");
   if (fs.existsSync(gitignorePath)) {
@@ -1347,12 +1414,36 @@ function getClientGuidance(client) {
       "Use the companion CLI only for explicit upload, planning, chunk lookup, doctor, and task commit workflows outside the editor UI."
     ];
   }
+  if (client === "windsurf") {
+    return [
+      "Windsurf should use the hosted MCP surface plus generated Windsurf automation bundles when available.",
+      "Use snipara-companion automations install --client windsurf when you want dashboard-managed hook files in the local project."
+    ];
+  }
   if (client === "codex") {
     return [
       "Codex should use the hosted MCP surface plus AGENTS.md as the canonical project instruction file.",
       "The generated .snipara/templates/codex-config.toml is a merge-ready snippet for ~/.codex/config.toml if your Codex app does not read project .codex/config.toml."
     ];
   }
+  if (client === "gemini") {
+    return [
+      "Gemini should use Hosted MCP plus the generated AGENTS.md rules; no local shell hooks are assumed.",
+      "Use .snipara/templates/gemini-mcp-reference.json as a field reference for the client's MCP settings."
+    ];
+  }
+  if (client === "vscode") {
+    return [
+      "VS Code and Copilot-style clients should use Hosted MCP plus AGENTS.md for project workflow rules.",
+      "Use .snipara/templates/vscode-mcp-reference.json as the Snipara server reference when adding an MCP server."
+    ];
+  }
+  if (client === "continue") {
+    return [
+      "Continue should use Hosted MCP for Snipara tools and keep AGENTS.md as the shared project instruction source.",
+      "Use .snipara/templates/continue-mcp-reference.json as the Snipara server reference when wiring MCP."
+    ];
+  }
   if (client === "chatgpt") {
     return [
       "ChatGPT and OpenAI-compatible MCP clients should use the direct hosted MCP endpoint.",
@@ -1366,13 +1457,13 @@ function getClientGuidance(client) {
     ];
   }
   return [
-    "The generated pack assumes Hosted MCP for agents and API / SDK for product integrations.",
-    "Use the companion CLI only when local planning, upload, doctor, or task commit flows help."
+    "The generated pack assumes a generic streamable HTTP MCP client plus AGENTS.md for shared workflow rules.",
+    "Use .snipara/templates/custom-mcp-reference.json as the server reference and use companion only when local planning, upload, doctor, or task commit flows help."
   ];
 }
 function getCompanionCommands(answers) {
   const projectIdFlag = answers.projectId ? ` --project-id ${answers.projectId}` : "";
-  const apiKeyFlag = answers.apiKeyType === "none" || answers.apiKey.includes("YOUR_") ? " --api-key <rlm-key>" : ` --api-key ${answers.apiKey}`;
+  const apiKeyFlag = " --api-key <snipara-key>";
   const clientFlag = getCompanionInitClientFlag(answers.aiClient);
   const businessOnboardingCommands = answers.installCompanion ? [
     {
@@ -1496,12 +1587,118 @@ function getCompanionCommands(answers) {
     }
   ];
 }
+function getClientDisplayName(client) {
+  const names = {
+    "claude-code": "Claude Code",
+    cursor: "Cursor",
+    windsurf: "Windsurf",
+    codex: "OpenAI Codex",
+    gemini: "Gemini",
+    chatgpt: "ChatGPT / OpenAI MCP",
+    vscode: "VS Code",
+    continue: "Continue",
+    "claude-desktop": "Claude Desktop",
+    other: "Custom MCP client"
+  };
+  return names[client];
+}
+function getClientPackFilename(client) {
+  const names = {
+    "claude-code": "CLAUDE_CODE.md",
+    cursor: "CURSOR.md",
+    windsurf: "WINDSURF.md",
+    codex: "CODEX.md",
+    gemini: "GEMINI.md",
+    chatgpt: "CHATGPT.md",
+    vscode: "VSCODE.md",
+    continue: "CONTINUE.md",
+    "claude-desktop": "CLAUDE_DESKTOP.md",
+    other: "CUSTOM_MCP.md"
+  };
+  return names[client];
+}
+function getClientConfigArtifacts(client) {
+  if (client === "claude-code") {
+    return ["AGENTS.md", "CLAUDE.md", ".claude/settings.json when hooks are installed"];
+  }
+  if (client === "cursor") {
+    return [".mcp.json", ".cursor/rules/snipara.mdc", "dashboard automation bundle when installed"];
+  }
+  if (client === "windsurf") {
+    return [".mcp.json", "dashboard automation bundle when installed"];
+  }
+  if (client === "codex") {
+    return ["AGENTS.md", ".codex/config.toml", ".snipara/templates/codex-config.toml"];
+  }
+  if (client === "gemini") {
+    return ["AGENTS.md", ".snipara/templates/gemini-mcp-reference.json"];
+  }
+  if (client === "vscode") {
+    return ["AGENTS.md", ".snipara/templates/vscode-mcp-reference.json"];
+  }
+  if (client === "continue") {
+    return ["AGENTS.md", ".snipara/templates/continue-mcp-reference.json"];
+  }
+  if (client === "chatgpt") {
+    return ["AGENTS.md", ".snipara/templates/chatgpt-openai-mcp.json"];
+  }
+  if (client === "claude-desktop") {
+    return ["AGENTS.md", "Claude Desktop MCP config"];
+  }
+  return ["AGENTS.md", ".snipara/templates/custom-mcp-reference.json"];
+}
+function getClientAutomationCommand(client) {
+  const companionClient = getCompanionInitClientFlag(client).match(/--client\s+(\S+)/)?.[1];
+  return companionClient ? `${COMPANION_COMMAND_NAME} automations install --client ${companionClient}` : null;
+}
+function buildClientPackMarkdown(answers, commands, guidance) {
+  const clientName = getClientDisplayName(answers.aiClient);
+  const automationCommand = getClientAutomationCommand(answers.aiClient);
+  const bootstrapCommand = commands.find(
+    (command) => command.title === "Bootstrap local companion"
+  );
+  return `# Snipara Pack: ${clientName}
+
+This pack is the client-specific overlay for the generated Snipara project setup.
+Use \`AGENTS.md\` as the shared source of agent behavior, then apply the client-specific files below.
+
+## Hosted MCP
+
+- Endpoint: \`${buildHostedMcpEndpoint(answers)}\`
+- Auth: \`SNIPARA_API_KEY\` from the environment or local client secret store
+- Do not commit API keys or bearer tokens.
+
+## Client Files
+
+${getClientConfigArtifacts(answers.aiClient).map((item) => `- \`${item}\``).join("\n")}
+
+## Recommended Setup
+
+${bootstrapCommand ? `1. Bootstrap companion: \`${bootstrapCommand.command}\`` : "1. Bootstrap companion with `snipara-companion init`."}
+2. Confirm the client can list or call the \`snipara_*\` MCP tools.
+3. Keep exact edits, tests, and dirty working-tree checks local; use Snipara for memory, source truth, and indexed code graph context.
+${automationCommand ? `4. For generated local automations, run \`${automationCommand}\` when that client exposes usable automation files.` : "4. This client is treated as MCP-first; no local hook surface is assumed."}
+
+## Client Guidance
+
+${guidance.map((line) => `- ${line}`).join("\n")}
+
+## Agent Workflow
+
+- Start substantial work with \`snipara_recall\` and \`snipara_context_query\`.
+- Use \`answer_pack\` facts, caveats, source maps, and verification checks before making claims.
+- Use \`snipara_code_symbol_card\` and \`snipara_code_impact\` for important symbols or risky multi-file changes when available.
+- Use \`snipara-companion workflow start\`, \`phase-start\`, \`phase-commit\`, \`workflow resume\`, and \`final-commit\` for multi-phase work.
+- Persist only durable decisions, learnings, preferences, workflows, and troubleshooting outcomes. Never persist secrets.
+`;
+}
 async function createCompanionPack(answers) {
   console.log(chalk.bold("\n\u{1F5C2}\uFE0F  Generating Companion Pack\n"));
   const packDir = path.join(process.cwd(), ".snipara", "companion");
   const commands = getCompanionCommands(answers);
   const guidance = getClientGuidance(answers.aiClient);
   const detection = detectEnvironment();
+  const clientPackFilename = getClientPackFilename(answers.aiClient);
   fs.mkdirSync(packDir, { recursive: true });
   const readme = `# Snipara Companion Pack
 
@@ -1513,6 +1710,7 @@ This project uses Snipara as a hosted-first context and memory layer with local
 - Project slug: \`${answers.projectSlug}\`
 - Project id: \`${answers.projectId || "not-set"}\`
 - AI client: \`${answers.aiClient}\`
+- Client pack: \`${clientPackFilename}\`
 - Installed local companion: \`${answers.installCompanion ? "yes" : "no"}\`
 - Generated hosted MCP config: \`${answers.profile !== "runtime-only" ? "yes" : "no"}\`
 - Installed local snipara-mcp package: \`${answers.installMcp ? "yes" : "no"}\`
@@ -1594,13 +1792,19 @@ ${item.purpose}`
     llm_provider: answers.llmProvider || null,
     github_repository: answers.githubRepo || null,
     github_automation_url: answers.githubRepo ? buildGitHubAutomationUrl(answers) : null,
+    client_pack: clientPackFilename,
     commands,
     guidance,
     detection
   };
   fs.writeFileSync(path.join(packDir, "README.md"), readme + "\n");
+  fs.writeFileSync(
+    path.join(packDir, clientPackFilename),
+    buildClientPackMarkdown(answers, commands, guidance) + "\n"
+  );
   fs.writeFileSync(path.join(packDir, "commands.json"), JSON.stringify(pack, null, 2) + "\n");
   console.log(chalk.green("   \u2713 Created .snipara/companion/README.md"));
+  console.log(chalk.green(`   \u2713 Created .snipara/companion/${clientPackFilename}`));
   console.log(chalk.green("   \u2713 Created .snipara/companion/commands.json"));
 }
 async function runSandboxInit() {
@@ -2143,12 +2347,36 @@ function detectAiClient() {
   if (fs.existsSync(path.join(process.cwd(), ".codex"))) {
     return "codex";
   }
+  if (fs.existsSync(path.join(process.cwd(), ".cursor"))) {
+    return "cursor";
+  }
+  if (fs.existsSync(path.join(process.cwd(), ".windsurf"))) {
+    return "windsurf";
+  }
+  if (fs.existsSync(path.join(process.cwd(), ".gemini"))) {
+    return "gemini";
+  }
+  if (fs.existsSync(path.join(process.cwd(), ".continue"))) {
+    return "continue";
+  }
+  if (fs.existsSync(path.join(process.cwd(), ".vscode"))) {
+    return "vscode";
+  }
   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";
   }
+  if (fs.existsSync(path.join(homedir(), ".windsurf")) || process.env.WINDSURF_EDITOR) {
+    return "windsurf";
+  }
+  if (fs.existsSync(path.join(homedir(), ".gemini")) || process.env.GEMINI_CLI) {
+    return "gemini";
+  }
+  if (fs.existsSync(path.join(homedir(), ".continue")) || process.env.CONTINUE_GLOBAL_DIR) {
+    return "continue";
+  }
   const claudeDesktopPath = process.platform === "darwin" ? path.join(homedir(), "Library", "Application Support", "Claude") : process.platform === "win32" ? path.join(homedir(), "AppData", "Roaming", "Claude") : path.join(homedir(), ".config", "claude");
   if (fs.existsSync(claudeDesktopPath)) {
     return "claude-desktop";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-snipara",
-  "version": "1.3.16",
+  "version": "1.3.17",
   "description": "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   "main": "dist/index.js",
   "type": "module",
@@ -32,6 +32,10 @@
     "chatgpt",
     "openai",
     "cursor",
+    "windsurf",
+    "gemini",
+    "vscode",
+    "continue",
     "claude-desktop"
   ],
   "author": "Snipara",