@tiny-fish/cli 0.2.0-next.78 → 0.2.0-next.80

package/README.md

@@ -10,6 +10,22 @@ npm install -g @tiny-fish/cli
 
 Requires Node.js 24+.
 
+### Connect Claude Code
+
+Add TinyFish, complete MCP OAuth, and start the interactive walkthrough with one command:
+
+```bash
+npx -y @tiny-fish/cli@latest connect claude-code --launch
+```
+
+One-command OAuth requires a Claude Code release whose `claude mcp` command supports `login`.
+Update Claude Code if the command reports that support is unavailable; older versions require
+manual authentication from `/mcp`.
+
+The command replaces existing user- and local-scope TinyFish registrations. It intentionally
+leaves project-scoped `.mcp.json` entries unchanged because those are shared repository
+configuration.
+
 ## Authentication
 
 Get your API key from [agent.tinyfish.ai](https://agent.tinyfish.ai).

package/dist/commands/connect.d.ts

@@ -0,0 +1,7 @@
+import { Command } from "commander";
+export declare const DEFAULT_ONBOARDING_PROMPT: string;
+export declare function connectClaudeCode(options: {
+    mcpUrl: string;
+    launch: boolean;
+}): void;
+export declare function registerConnect(program: Command): void;

package/dist/commands/connect.js

@@ -0,0 +1,101 @@
+import spawn from "cross-spawn";
+import { errLine } from "../lib/output.js";
+const DEFAULT_MCP_URL = "https://agent.tinyfish.ai/mcp";
+const NON_INTERACTIVE_TIMEOUT_MS = 10_000;
+const MCP_LOGIN_UNAVAILABLE_MESSAGE = "This Claude Code installation does not expose `claude mcp login`, which is required for " +
+    "one-command MCP authentication. Update Claude Code and retry, or authenticate TinyFish " +
+    "manually from /mcp.";
+export const DEFAULT_ONBOARDING_PROMPT = "I just connected TinyFish. Call the guide_next_step tool and walk me through it one step at a " +
+    "time. Ask for my input and wait for my reply before every tool call.";
+function requireNativeMcpLogin() {
+    const result = spawn.sync("claude", ["mcp", "--help"], {
+        encoding: "utf8",
+        timeout: NON_INTERACTIVE_TIMEOUT_MS,
+    });
+    if (result.error || result.status !== 0) {
+        throw new Error(MCP_LOGIN_UNAVAILABLE_MESSAGE, { cause: result.error });
+    }
+    if (!/^\s*login(?:\s|\[)/m.test(result.stdout ?? "")) {
+        throw new Error(MCP_LOGIN_UNAVAILABLE_MESSAGE);
+    }
+}
+function removeExistingRegistration(scope) {
+    const result = spawn.sync("claude", ["mcp", "remove", "tinyfish", "--scope", scope], {
+        encoding: "utf8",
+        timeout: NON_INTERACTIVE_TIMEOUT_MS,
+    });
+    if (result.status === 0)
+        return;
+    const details = result.stderr?.trim() || result.error?.message || "unknown error";
+    if (/No MCP server named "tinyfish"/i.test(details))
+        return;
+    if (result.error) {
+        throw new Error(`Could not remove existing ${scope} TinyFish registration: ${details}`, {
+            cause: result.error,
+        });
+    }
+    throw new Error(`Could not remove existing ${scope} TinyFish registration: ${details}`);
+}
+export function connectClaudeCode(options) {
+    requireNativeMcpLogin();
+    // Project scope is shared in .mcp.json; a user setup command must not rewrite it.
+    removeExistingRegistration("user");
+    removeExistingRegistration("local");
+    errLine("Adding TinyFish to Claude Code...");
+    const addResult = spawn.sync("claude", ["mcp", "add", "--scope", "user", "--transport", "http", "tinyfish", options.mcpUrl], { stdio: "inherit" });
+    if (addResult.error || addResult.status !== 0) {
+        throw new Error("Could not add TinyFish to Claude Code", { cause: addResult.error });
+    }
+    errLine("Signing in to TinyFish...");
+    const loginResult = spawn.sync("claude", ["mcp", "login", "tinyfish"], { stdio: "inherit" });
+    if (loginResult.error || loginResult.status !== 0) {
+        throw new Error("Could not authenticate TinyFish in Claude Code", {
+            cause: loginResult.error,
+        });
+    }
+    if (!options.launch) {
+        errLine("TinyFish is connected. Open Claude Code to start using it.");
+        return;
+    }
+    errLine("Starting the TinyFish walkthrough in Claude Code...");
+    const result = spawn.sync("claude", [DEFAULT_ONBOARDING_PROMPT], { stdio: "inherit" });
+    if (result.error) {
+        throw new Error("Could not launch Claude Code", { cause: result.error });
+    }
+    if (result.signal === "SIGINT" || result.signal === "SIGTERM")
+        return;
+    if (result.status !== 0) {
+        throw new Error(`Claude Code walkthrough exited with status ${result.status ?? "unknown"}`);
+    }
+}
+export function registerConnect(program) {
+    program
+        .command("connect")
+        .description("Connect TinyFish to an AI agent")
+        .argument("<client>", "Agent client to connect (claude-code)")
+        .option("--launch", "Launch the agent and start the TinyFish walkthrough")
+        .option("--url <mcpUrl>", "MCP endpoint override")
+        .action((client, options) => {
+        if (client !== "claude-code") {
+            throw new Error(`Unsupported client: ${client}. Supported client: claude-code`);
+        }
+        const mcpUrl = options.url ?? DEFAULT_MCP_URL;
+        if (mcpUrl.startsWith("-")) {
+            throw new Error(`Invalid --url value: ${mcpUrl}`);
+        }
+        let parsedUrl;
+        try {
+            parsedUrl = new URL(mcpUrl);
+        }
+        catch {
+            throw new Error(`Invalid --url value: ${mcpUrl}`);
+        }
+        if (!["http:", "https:"].includes(parsedUrl.protocol)) {
+            throw new Error(`Invalid --url value: ${mcpUrl}`);
+        }
+        connectClaudeCode({
+            mcpUrl,
+            launch: options.launch ?? false,
+        });
+    });
+}

package/dist/index.js

@@ -11,6 +11,7 @@ import { registerRun } from "./commands/run.js";
 import { registerRuns } from "./commands/runs.js";
 import { registerConfigureClaude } from "./commands/config-claude.js";
 import { registerSearch } from "./commands/search.js";
+import { registerConnect } from "./commands/connect.js";
 const { version } = createRequire(import.meta.url)("../package.json");
 const program = new Command();
 program
@@ -27,6 +28,7 @@ program
     }
 });
 registerAuth(program);
+registerConnect(program);
 registerConfigureClaude(program);
 registerBrowser(program);
 registerProfile(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiny-fish/cli",
-  "version": "0.2.0-next.78",
+  "version": "0.2.0-next.80",
   "description": "TinyFish CLI — run web automations from your terminal",
   "type": "module",
   "bin": {
@@ -35,11 +35,13 @@
     "@tiny-fish/sdk": "^0.0.11",
     "chrome-cookies-secure": "^3.0.2",
     "commander": "^12.0.0",
+    "cross-spawn": "^7.0.6",
     "globals": "^17.4.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "@types/cross-spawn": "^6.0.6",
     "@types/node": "^20.0.0",
     "@typescript-eslint/eslint-plugin": "^8.57.2",
     "@typescript-eslint/parser": "^8.57.2",
@@ -53,7 +55,7 @@
     "vite": "7.3.5",
     "brace-expansion": "^5.0.7",
     "postcss": "8.5.10",
-    "tar": "^7"
+    "tar": "^7.5.20"
   },
   "engines": {
     "node": ">=24.0.0"