@tiny-fish/cli 0.4.1-next.92 → 0.5.0

package/README.md

@@ -49,6 +49,18 @@ npx -y @tiny-fish/cli@latest connect hermes --launch
 Hermes completes OAuth while adding the MCP server. After setup, the command starts the walkthrough
 in a Hermes session and leaves that session open for your replies.
 
+### Connect OpenClaw
+
+Install the TinyFish skill, sign in with an API key, and start an interactive walkthrough with one
+command:
+
+```bash
+npx -y @tiny-fish/cli@latest connect openclaw --launch
+```
+
+OpenClaw must already be installed. The command installs the TinyFish skill for all local OpenClaw
+agents and guides you through Search, Fetch, and Agent one step at a time.
+
 ## Authentication
 
 Get your API key from [agent.tinyfish.ai](https://agent.tinyfish.ai).

package/dist/commands/connect.d.ts

@@ -1,5 +1,6 @@
 import { Command } from "commander";
 export declare const DEFAULT_ONBOARDING_PROMPT: string;
+export declare const OPENCLAW_ONBOARDING_PROMPT: string;
 export declare function connectClaudeCode(options: {
     mcpUrl: string;
     launch: boolean;
@@ -12,4 +13,7 @@ export declare function connectHermes(options: {
     mcpUrl: string;
     launch: boolean;
 }): void;
+export declare function connectOpenClaw(options: {
+    launch: boolean;
+}): void;
 export declare function registerConnect(program: Command): void;

package/dist/commands/connect.js

@@ -10,15 +10,23 @@ const CODEX_OAUTH_RESOURCE_UNAVAILABLE_MESSAGE = "This Codex installation does n
     "retry, or add TinyFish manually with `codex mcp add`.";
 const HERMES_OAUTH_UNAVAILABLE_MESSAGE = "This Hermes installation does not support one-command MCP authentication. Update Hermes and " +
     "retry, or add TinyFish manually with `hermes mcp add`.";
+const OPENCLAW_SKILL_UNAVAILABLE_MESSAGE = "This OpenClaw installation does not support global skill installation. Update OpenClaw and " +
+    "retry.";
+const TINYFISH_CLI_NOT_FOUND_MESSAGE = "TinyFish CLI installed but is not available on PATH. Open a new terminal and retry.";
+const OPENCLAW_SKILL = "@tinyfish/tinyfish";
 export const DEFAULT_ONBOARDING_PROMPT = "I just connected TinyFish. Call the guide_next_step tool now to begin. Then follow its " +
     "instructions one step at a time. Ask for my input and wait for my reply before each subsequent " +
     "TinyFish tool call.";
+export const OPENCLAW_ONBOARDING_PROMPT = "I just installed the TinyFish skill. Guide me through it interactively: first ask what topic I " +
+    "want to search and wait for my reply before using TinyFish Search. Show me the results, ask " +
+    "which result I want to read, and wait before using TinyFish Fetch. Then ask what browser task " +
+    "I want to complete and wait before using TinyFish Agent. Never skip ahead or choose for me.";
 const CLAUDE_CODE = {
     command: "claude",
     displayName: "Claude Code",
     supportCheck: {
         args: ["mcp", "--help"],
-        pattern: /^\s*login(?:\s|\[)/m,
+        patterns: [/^\s*login(?:\s|\[)/m],
         unavailableMessage: MCP_LOGIN_UNAVAILABLE_MESSAGE,
     },
     loginArgs: ["mcp", "login", "tinyfish"],
@@ -37,7 +45,7 @@ const CODEX = {
     displayName: "Codex",
     supportCheck: {
         args: ["mcp", "add", "--help"],
-        pattern: /--oauth-resource(?:\s|<)/,
+        patterns: [/--oauth-resource(?:\s|<)/],
         unavailableMessage: CODEX_OAUTH_RESOURCE_UNAVAILABLE_MESSAGE,
     },
     removals: [{ args: ["mcp", "remove", "tinyfish"], label: "TinyFish registration from Codex" }],
@@ -72,7 +80,7 @@ const HERMES = {
     displayName: "Hermes",
     supportCheck: {
         args: ["mcp", "add", "--help"],
-        pattern: /--auth\s+\{[^}]*oauth[^}]*\}/,
+        patterns: [/--auth\s+\{[^}]*oauth[^}]*\}/],
         unavailableMessage: HERMES_OAUTH_UNAVAILABLE_MESSAGE,
     },
     removals: [{ args: ["mcp", "remove", "tinyfish"], label: "TinyFish registration from Hermes" }],
@@ -80,12 +88,21 @@ const HERMES = {
     addArgs: (mcpUrl) => ["mcp", "add", "tinyfish", "--url", mcpUrl, "--auth", "oauth"],
     launchWalkthrough: launchHermesWalkthrough,
 };
-function requireNativeMcpSupport(client) {
+const OPENCLAW = {
+    command: "openclaw",
+    displayName: "OpenClaw",
+    supportCheck: {
+        args: ["skills", "install", "--help"],
+        patterns: [/--global(?:\s|$)/, /--acknowledge-clawhub-risk(?:\s|$)/],
+        unavailableMessage: OPENCLAW_SKILL_UNAVAILABLE_MESSAGE,
+    },
+};
+function requireCommandSupport(client) {
     const result = spawn.sync(client.command, client.supportCheck.args, {
         encoding: "utf8",
         timeout: NON_INTERACTIVE_TIMEOUT_MS,
     });
-    if (result.error?.code === "ENOENT") {
+    if (commandNotFound(result.error)) {
         throw new Error(`${client.displayName} is not installed or not available on PATH.`, {
             cause: result.error,
         });
@@ -94,10 +111,13 @@ function requireNativeMcpSupport(client) {
         throw new Error(client.supportCheck.unavailableMessage, { cause: result.error });
     }
     const output = `${result.stdout ?? ""}\n${result.stderr ?? ""}`;
-    if (!client.supportCheck.pattern.test(output)) {
+    if (!client.supportCheck.patterns.every((pattern) => pattern.test(output))) {
         throw new Error(client.supportCheck.unavailableMessage);
     }
 }
+function commandNotFound(error) {
+    return error?.code === "ENOENT";
+}
 function removeExistingRegistration(client, removal) {
     const result = spawn.sync(client.command, removal.args, {
         encoding: "utf8",
@@ -116,7 +136,7 @@ function removeExistingRegistration(client, removal) {
     throw new Error(`Could not remove existing ${removal.label}: ${details}`);
 }
 function connectNativeMcpClient(client, options) {
-    requireNativeMcpSupport(client);
+    requireCommandSupport(client);
     for (const removal of client.removals)
         removeExistingRegistration(client, removal);
     errLine(`Adding TinyFish to ${client.displayName}...`);
@@ -167,11 +187,63 @@ export function connectCodex(options) {
 export function connectHermes(options) {
     connectNativeMcpClient(HERMES, options);
 }
+export function connectOpenClaw(options) {
+    requireCommandSupport(OPENCLAW);
+    errLine("Installing the TinyFish CLI...");
+    const cliInstallResult = spawn.sync("npm", ["install", "--global", "@tiny-fish/cli@latest"], { stdio: "inherit" });
+    if (cliInstallResult.error || cliInstallResult.status !== 0) {
+        throw new Error("Could not install the TinyFish CLI", { cause: cliInstallResult.error });
+    }
+    errLine("Installing the TinyFish skill in OpenClaw...");
+    const skillInstallResult = spawn.sync("openclaw", [
+        "skills",
+        "install",
+        OPENCLAW_SKILL,
+        "--global",
+        "--force",
+        "--acknowledge-clawhub-risk",
+    ], { stdio: "inherit" });
+    if (skillInstallResult.error || skillInstallResult.status !== 0) {
+        throw new Error("Could not install the TinyFish skill in OpenClaw", {
+            cause: skillInstallResult.error,
+        });
+    }
+    const authStatus = spawn.sync("tinyfish", ["auth", "status"], { stdio: "ignore" });
+    if (commandNotFound(authStatus.error)) {
+        throw new Error(TINYFISH_CLI_NOT_FOUND_MESSAGE, { cause: authStatus.error });
+    }
+    if (authStatus.status !== 0) {
+        errLine("Signing in to TinyFish...");
+        const loginResult = spawn.sync("tinyfish", ["auth", "login", "--source", "openclaw"], { stdio: "inherit" });
+        if (commandNotFound(loginResult.error)) {
+            throw new Error(TINYFISH_CLI_NOT_FOUND_MESSAGE, { cause: loginResult.error });
+        }
+        if (loginResult.error || loginResult.status !== 0) {
+            throw new Error("Could not authenticate TinyFish for OpenClaw", {
+                cause: loginResult.error,
+            });
+        }
+    }
+    if (!options.launch) {
+        errLine("TinyFish is connected. Open OpenClaw to start using it.");
+        return;
+    }
+    errLine("Starting the TinyFish walkthrough in OpenClaw...");
+    const launchResult = spawn.sync("openclaw", ["chat", "--message", OPENCLAW_ONBOARDING_PROMPT], { stdio: "inherit" });
+    if (launchResult.error) {
+        throw new Error("Could not launch OpenClaw", { cause: launchResult.error });
+    }
+    if (launchResult.signal === "SIGINT" || launchResult.signal === "SIGTERM")
+        return;
+    if (launchResult.status !== 0) {
+        throw new Error(`OpenClaw walkthrough exited with status ${launchResult.status ?? "unknown"}`);
+    }
+}
 export function registerConnect(program) {
     program
         .command("connect")
         .description("Connect TinyFish to an AI agent")
-        .argument("<client>", "Agent client to connect (claude-code, codex, or hermes)")
+        .argument("<client>", "Agent client to connect (claude-code, codex, hermes, or openclaw)")
         .option("--launch", "Launch the agent and start the TinyFish walkthrough")
         .option("--url <mcpUrl>", "MCP endpoint override")
         .action((client, options) => {
@@ -199,8 +271,11 @@ export function registerConnect(program) {
         else if (client === "hermes") {
             connectHermes(connectOptions);
         }
+        else if (client === "openclaw") {
+            connectOpenClaw({ launch: connectOptions.launch });
+        }
         else {
-            throw new Error(`Unsupported client: ${client}. Supported clients: claude-code, codex, hermes`);
+            throw new Error(`Unsupported client: ${client}. Supported clients: claude-code, codex, hermes, openclaw`);
         }
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiny-fish/cli",
-  "version": "0.4.1-next.92",
+  "version": "0.5.0",
   "description": "TinyFish CLI — run web automations from your terminal",
   "type": "module",
   "bin": {