@tiny-fish/cli 0.2.2 → 0.3.1-next.87

package/README.md

@@ -38,6 +38,17 @@ One-command OAuth requires a Codex release whose `codex mcp add` command support
 `--oauth-resource`. Update Codex if support is unavailable, or add TinyFish manually with
 `codex mcp add`.
 
+### Connect Hermes
+
+Add TinyFish, complete MCP OAuth, and start the interactive walkthrough with one command:
+
+```bash
+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.
+
 ## Authentication
 
 Get your API key from [agent.tinyfish.ai](https://agent.tinyfish.ai).

package/dist/commands/connect.d.ts

@@ -8,4 +8,8 @@ export declare function connectCodex(options: {
     mcpUrl: string;
     launch: boolean;
 }): void;
+export declare function connectHermes(options: {
+    mcpUrl: string;
+    launch: boolean;
+}): void;
 export declare function registerConnect(program: Command): void;

package/dist/commands/connect.js

@@ -2,11 +2,14 @@ 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 HERMES_SEED_TIMEOUT_MS = 120_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.";
 const CODEX_OAUTH_RESOURCE_UNAVAILABLE_MESSAGE = "This Codex installation does not support one-command MCP authentication. Update Codex and " +
     "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`.";
 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.";
@@ -38,15 +41,44 @@ const CODEX = {
         unavailableMessage: CODEX_OAUTH_RESOURCE_UNAVAILABLE_MESSAGE,
     },
     removals: [{ args: ["mcp", "remove", "tinyfish"], label: "TinyFish registration from Codex" }],
-    addArgs: (mcpUrl) => [
-        "mcp",
-        "add",
-        "tinyfish",
-        "--url",
-        mcpUrl,
-        "--oauth-resource",
-        mcpUrl,
-    ],
+    addArgs: (mcpUrl) => ["mcp", "add", "tinyfish", "--url", mcpUrl, "--oauth-resource", mcpUrl],
+};
+function launchHermesWalkthrough() {
+    const seedResult = spawn.sync("hermes", ["chat", "-Q", "-q", DEFAULT_ONBOARDING_PROMPT], {
+        encoding: "utf8",
+        timeout: HERMES_SEED_TIMEOUT_MS,
+    });
+    if (seedResult.error || seedResult.status !== 0) {
+        throw new Error("Could not start the TinyFish walkthrough in Hermes", {
+            cause: seedResult.error,
+        });
+    }
+    const sessionId = seedResult.stderr?.match(/session_id:\s*([^\s]+)/i)?.[1];
+    if (!sessionId) {
+        throw new Error("Hermes did not return a walkthrough session ID");
+    }
+    const result = spawn.sync("hermes", ["--resume", sessionId], { stdio: "inherit" });
+    if (result.error) {
+        throw new Error("Could not launch Hermes", { cause: result.error });
+    }
+    if (result.signal === "SIGINT" || result.signal === "SIGTERM")
+        return;
+    if (result.status !== 0) {
+        throw new Error(`Hermes walkthrough exited with status ${result.status ?? "unknown"}`);
+    }
+}
+const HERMES = {
+    command: "hermes",
+    displayName: "Hermes",
+    supportCheck: {
+        args: ["mcp", "add", "--help"],
+        pattern: /--auth\s+\{[^}]*oauth[^}]*\}/,
+        unavailableMessage: HERMES_OAUTH_UNAVAILABLE_MESSAGE,
+    },
+    removals: [{ args: ["mcp", "remove", "tinyfish"], label: "TinyFish registration from Hermes" }],
+    // Hermes completes OAuth while adding the server; a separate `mcp login` would authenticate twice.
+    addArgs: (mcpUrl) => ["mcp", "add", "tinyfish", "--url", mcpUrl, "--auth", "oauth"],
+    launchWalkthrough: launchHermesWalkthrough,
 };
 function requireNativeMcpSupport(client) {
     const result = spawn.sync(client.command, client.supportCheck.args, {
@@ -112,6 +144,10 @@ function connectNativeMcpClient(client, options) {
         return;
     }
     errLine(`Starting the TinyFish walkthrough in ${client.displayName}...`);
+    if (client.launchWalkthrough) {
+        client.launchWalkthrough();
+        return;
+    }
     const result = spawn.sync(client.command, [DEFAULT_ONBOARDING_PROMPT], { stdio: "inherit" });
     if (result.error) {
         throw new Error(`Could not launch ${client.displayName}`, { cause: result.error });
@@ -128,11 +164,14 @@ export function connectClaudeCode(options) {
 export function connectCodex(options) {
     connectNativeMcpClient(CODEX, options);
 }
+export function connectHermes(options) {
+    connectNativeMcpClient(HERMES, options);
+}
 export function registerConnect(program) {
     program
         .command("connect")
         .description("Connect TinyFish to an AI agent")
-        .argument("<client>", "Agent client to connect (claude-code or codex)")
+        .argument("<client>", "Agent client to connect (claude-code, codex, or hermes)")
         .option("--launch", "Launch the agent and start the TinyFish walkthrough")
         .option("--url <mcpUrl>", "MCP endpoint override")
         .action((client, options) => {
@@ -157,8 +196,11 @@ export function registerConnect(program) {
         else if (client === "codex") {
             connectCodex(connectOptions);
         }
+        else if (client === "hermes") {
+            connectHermes(connectOptions);
+        }
         else {
-            throw new Error(`Unsupported client: ${client}. Supported clients: claude-code, codex`);
+            throw new Error(`Unsupported client: ${client}. Supported clients: claude-code, codex, hermes`);
         }
     });
 }

package/package.json

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