@tiny-fish/cli 0.13.1-next.145 → 0.13.1-next.148

package/dist/commands/connect.d.ts

@@ -3,7 +3,7 @@ export declare const DEFAULT_MCP_URL = "https://agent.tinyfish.ai/mcp";
 export declare const UPGRADE_HINT = "Run `tinyfish upgrade` any time to update the CLI and skill.";
 export declare const DEFAULT_ONBOARDING_PROMPT: string;
 export declare const OPENCLAW_ONBOARDING_PROMPT: string;
-export type AgentClient = "claude-code" | "codex" | "cursor" | "hermes" | "openclaw";
+export type AgentClient = "claude-code" | "codex" | "cursor" | "hermes" | "openclaw" | "opencode";
 /** Ctrl+C/SIGTERM killed a setup child — abandonment, not error. */
 export declare class ConnectInterruptedError extends Error {
 }
@@ -32,6 +32,11 @@ export declare function connectHermes(options: {
     mcpUrl: string;
     launch: boolean;
 }): Promise<void>;
+export declare function connectOpencode(options: {
+    apiKey?: string;
+    mcpUrl: string;
+    launch: boolean;
+}): Promise<void>;
 export declare function connectOpenClaw(options: {
     mcpUrl: string;
     launch: boolean;

package/dist/commands/connect.js

@@ -24,6 +24,13 @@ const HERMES_OAUTH_UNAVAILABLE_MESSAGE = "This Hermes installation does not supp
     "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 OPENCODE_MCP_ADD_UNAVAILABLE_MESSAGE = "This OpenCode installation does not support one-command MCP setup (`opencode mcp add --url`). " +
+    "Update OpenCode and retry, or add TinyFish manually with `opencode mcp add`.";
+// OpenCode is model-agnostic (unlike Claude Code / Codex), so a fresh install can default to a
+// model with no tool support — TinyFish runs entirely on tool calls, so it would fail there.
+const OPENCODE_MODEL_NOTE = "Note: TinyFish runs on tool calls, so OpenCode needs a model that supports tool use. Image-only " +
+    'models (e.g. Nano Banana Pro) will show "No endpoints found that support tool use" — switch ' +
+    "OpenCode's model if the walkthrough can't start.";
 const TINYFISH_CLI_NOT_FOUND_MESSAGE = "TinyFish CLI installed but is not available on PATH. Open a new terminal and retry.";
 const TINYFISH_CLI_PACKAGE = "@tiny-fish/cli@latest";
 export const UPGRADE_HINT = "Run `tinyfish upgrade` any time to update the CLI and skill.";
@@ -217,6 +224,40 @@ const HERMES = {
     addArgs: (mcpUrl) => ["mcp", "add", "tinyfish", "--url", mcpUrl, "--auth", "oauth"],
     launchWalkthrough: launchHermesWalkthrough,
 };
+// OpenCode's TUI takes a positional as a project directory, so a bare `opencode "<prompt>"`
+// would be read as a folder. The `--prompt` flag seeds the interactive TUI with a first message
+// (opencode.ai/docs/cli), so the onboarding guide fires just like the other agents.
+function launchOpencode() {
+    const result = spawn.sync("opencode", ["--prompt", DEFAULT_ONBOARDING_PROMPT], {
+        stdio: "inherit",
+    });
+    if (result.error) {
+        throw new Error("Could not launch OpenCode", { cause: result.error });
+    }
+    if (result.signal === "SIGINT" || result.signal === "SIGTERM")
+        return;
+    if (result.status !== 0) {
+        throw new Error(`OpenCode exited with status ${result.status ?? "unknown"}`);
+    }
+}
+const OPENCODE = {
+    command: "opencode",
+    connectClient: "opencode",
+    skillAgent: "opencode",
+    displayName: "OpenCode",
+    supportCheck: {
+        args: ["mcp", "add", "--help"],
+        patterns: [/--url(?:\s|$)/m],
+        unavailableMessage: OPENCODE_MCP_ADD_UNAVAILABLE_MESSAGE,
+    },
+    // `opencode mcp add` upserts by name and there is no `opencode mcp remove`, so no cleanup step.
+    removals: [],
+    // OpenCode writes ~/.config/opencode/opencode.jsonc itself; `mcp auth` is the separate OAuth step.
+    addArgs: (mcpUrl) => ["mcp", "add", "tinyfish", "--url", mcpUrl],
+    loginArgs: ["mcp", "auth", "tinyfish"],
+    launchWalkthrough: launchOpencode,
+    postConnectNote: OPENCODE_MODEL_NOTE,
+};
 const OPENCLAW = {
     command: "openclaw",
     displayName: "OpenClaw",
@@ -380,7 +421,7 @@ const SKILL_INSTALL_FAILURE_PATTERN = /Failed to install/;
 export function updateWebSkill() {
     // One entry per `tinyfish connect <client>`, persisted by PF-3169.
     const connected = loadConfig().connect ?? {};
-    const skillAgents = [CLAUDE_CODE, CODEX, HERMES]
+    const skillAgents = [CLAUDE_CODE, CODEX, HERMES, OPENCODE]
         .filter((client) => connected[client.connectClient])
         .map((client) => client.skillAgent);
     const hasOpenClaw = Boolean(connected["openclaw"]);
@@ -594,6 +635,8 @@ async function connectNativeMcpClient(client, options) {
         // or not, record the install; buildConnectHeaders reads it on subsequent requests.
         saveConnectContext(client.connectClient, telemetry.attemptId);
         errLine(UPGRADE_HINT);
+        if (client.postConnectNote)
+            errLine(client.postConnectNote);
         if (!options.launch) {
             errLine(`TinyFish is connected. Open ${client.displayName} to start using it.`);
             settle(state, telemetry, "completed");
@@ -614,6 +657,9 @@ export async function connectCodex(options) {
 export async function connectHermes(options) {
     await connectNativeMcpClient(HERMES, options);
 }
+export async function connectOpencode(options) {
+    await connectNativeMcpClient(OPENCODE, options);
+}
 export async function connectOpenClaw(options) {
     const telemetry = createConnectTelemetry(options.mcpUrl, "openclaw");
     const state = { stage: "prerequisite_check", settled: false };
@@ -686,7 +732,9 @@ export async function connectCursor(options) {
         state.stage = "authentication";
         ensureCliAuthenticated("cursor", options.apiKey);
         telemetry.track("checkpoint", { phase: "authenticated" });
-        const resolvedKey = options.apiKey ?? process.env["TINYFISH_API_KEY"] ?? loadConfig().api_key;
+        // loadConfig() is unvalidated on read — a hand-edited key must not reach mcp.json.
+        const storedKey = options.apiKey ?? process.env["TINYFISH_API_KEY"] ?? loadConfig().api_key;
+        const resolvedKey = storedKey && validateKeyFormat(storedKey) ? storedKey : undefined;
         state.stage = "registration";
         errLine("Adding TinyFish to Cursor...");
         const mcpUrl = new URL(options.mcpUrl);
@@ -747,6 +795,9 @@ export function launchAgent(client) {
     else if (client === "hermes") {
         launchNativeMcpClient(HERMES);
     }
+    else if (client === "opencode") {
+        launchNativeMcpClient(OPENCODE);
+    }
     else if (client === "openclaw") {
         launchOpenClawWalkthrough();
     }
@@ -763,7 +814,7 @@ export function registerConnect(program) {
     program
         .command("connect")
         .description("Connect TinyFish to an AI agent")
-        .argument("[client]", "Agent client to connect (claude-code, codex, cursor, hermes, or openclaw)")
+        .argument("[client]", "Agent client to connect (claude-code, codex, cursor, hermes, openclaw, or opencode)")
         .option("--all", "Detect and connect every supported harness found on this machine")
         .option("--dry-run", "Print planned writes per harness without touching anything (--all only)")
         .option("--uninstall", "Remove TinyFish entries written by connect --all")
@@ -808,8 +859,8 @@ export function registerConnect(program) {
                 process.exitCode = exitCode;
             return;
         }
-        if (options.dryRun || options.uninstall) {
-            throw new Error("--dry-run and --uninstall are only supported with --all.");
+        if (options.dryRun || options.uninstall || options.skipLaunch) {
+            throw new Error("--dry-run, --uninstall and --skip-launch are only supported with --all.");
         }
         if (!client) {
             throw new Error("Pass a client (claude-code, codex, cursor, hermes, openclaw) or --all.");
@@ -824,6 +875,9 @@ export function registerConnect(program) {
         else if (client === "hermes") {
             await connectHermes(connectOptions);
         }
+        else if (client === "opencode") {
+            await connectOpencode(connectOptions);
+        }
         else if (client === "openclaw") {
             await connectOpenClaw({ mcpUrl: connectOptions.mcpUrl, launch: connectOptions.launch });
         }
@@ -838,7 +892,7 @@ export function registerConnect(program) {
         else {
             throw new Error("Unsupported client: " +
                 client +
-                ". Supported clients: claude-code, codex, cursor, hermes, openclaw");
+                ". Supported clients: claude-code, codex, cursor, hermes, openclaw, opencode");
         }
         // Deferred to here so the notice lands after install output, not interleaved with it.
         emitNotice();

package/dist/commands/onboard.js

@@ -3,7 +3,7 @@ import { getApiKey, saveConfig } from "../lib/auth.js";
 import { fetchContentGet, searchQuery } from "../lib/client.js";
 import { BASE_URL } from "../lib/constants.js";
 import { errLine, handleApiError, outLine } from "../lib/output.js";
-import { connectClaudeCode, connectCodex, connectHermes, connectOpenClaw, launchAgent, } from "./connect.js";
+import { connectClaudeCode, connectCodex, connectHermes, connectOpenClaw, connectOpencode, launchAgent, } from "./connect.js";
 const EXAMPLE_QUERIES = [
     "What are recent changes in the AI dev stack? Give me the top 5 changes that matter, why they matter, and any action needed.",
     "Find a new-grad software engineering role posted in the last 24 hours and fetch the job description.",
@@ -14,6 +14,7 @@ const AGENTS = [
     { id: "codex", label: "Codex", connect: connectCodex },
     { id: "hermes", label: "Hermes", connect: connectHermes },
     { id: "openclaw", label: "OpenClaw", connect: connectOpenClaw },
+    { id: "opencode", label: "OpenCode", connect: connectOpencode },
 ];
 function cleanFetchedContent(text) {
     const cleaned = text
@@ -208,7 +209,7 @@ export function registerOnboard(program) {
         .argument("[query]", "A real topic to research")
         .addHelpText("after", "\nExamples:\n" +
         '  tinyfish onboard "What changed in the AI dev stack this week?"\n' +
-        "\nAgents: claude-code, codex, hermes, openclaw.\n" +
+        "\nAgents: claude-code, codex, hermes, openclaw, opencode.\n" +
         "Run `tinyfish connect <client> --launch` later to add one directly.")
         .action(async (query) => {
         const apiKey = getApiKey();

package/dist/lib/harness.js

@@ -21,6 +21,10 @@ const HARNESS_FINGERPRINTS = [
     // prefix so we catch a Codex run regardless of which of its vars are set.
     { name: "codex", matches: (env) => hasVarWithPrefix(env, "CODEX_") },
     { name: "hermes", matches: (env) => hasVarWithPrefix(env, "HERMES_") },
+    // OpenCode sets a bare `OPENCODE` env var globally at startup (opencode#9292), inherited by
+    // the commands it shells out. Exact key, not a prefix — `OPENCODE_*` are user config inputs.
+    // Sourced from OpenCode's docs, not yet confirmed against scripts/harness-probe.
+    { name: "opencode", matches: (env) => Boolean(env["OPENCODE"]) },
     {
         name: "claude-code",
         matches: (env) => env["CLAUDECODE"] === "1" || Boolean(env["CLAUDE_CODE_ENTRYPOINT"]),

package/package.json

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