straylight-ai 0.1.0

package/src/mcp-register.ts

@@ -0,0 +1,62 @@
+import { execSync, spawnSync } from "child_process";
+
+/** Name to use when registering the MCP server */
+const MCP_SERVER_NAME = "straylight-ai";
+
+/**
+ * Check whether the Claude Code CLI is available on PATH.
+ */
+export function isClaudeAvailable(): boolean {
+  try {
+    execSync("claude --version", { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Register the Straylight-AI MCP server with Claude Code.
+ *
+ * Runs:
+ *   claude mcp add straylight-ai --transport stdio -- npx straylight-ai mcp
+ *
+ * @returns true on success, false if claude is unavailable or the command fails.
+ */
+export async function registerMCP(): Promise<boolean> {
+  if (!isClaudeAvailable()) {
+    return false;
+  }
+
+  const result = spawnSync(
+    "claude",
+    [
+      "mcp",
+      "add",
+      MCP_SERVER_NAME,
+      "--transport",
+      "stdio",
+      "--",
+      "npx",
+      "straylight-ai",
+      "mcp",
+    ],
+    { stdio: "pipe" }
+  );
+
+  return result.status === 0;
+}
+
+/**
+ * Build the manual registration instructions string for users who do not have
+ * Claude Code installed.
+ */
+export function manualRegistrationInstructions(): string {
+  return [
+    "To register the MCP server manually, run:",
+    "",
+    "  claude mcp add straylight-ai --transport stdio -- npx straylight-ai mcp",
+    "",
+    "Or add it directly to your Claude Code settings.",
+  ].join("\n");
+}

package/src/open.ts

@@ -0,0 +1,33 @@
+import { spawn } from "child_process";
+import * as os from "os";
+
+/**
+ * Open the given URL in the system's default browser.
+ * Best-effort: failure is silent to avoid blocking the setup flow.
+ */
+export async function openBrowser(url: string): Promise<void> {
+  const platform = os.platform();
+  let command: string;
+
+  if (platform === "darwin") {
+    command = "open";
+  } else if (platform === "win32") {
+    command = "start";
+  } else {
+    command = "xdg-open";
+  }
+
+  return new Promise<void>((resolve) => {
+    try {
+      const child = spawn(command, [url], {
+        stdio: "ignore",
+        detached: true,
+      });
+      child.unref();
+    } catch {
+      // Best-effort: ignore errors opening the browser
+    }
+    // Resolve immediately; we don't wait for the browser to finish
+    resolve();
+  });
+}