theclawbay 0.3.27 → 0.3.28

package/README.md

@@ -17,8 +17,7 @@ theclawbay setup --api-key <apiKey>
 ```
 
 In an interactive terminal, setup shows one picker for Codex, Continue, Cline, OpenClaw, OpenCode, Kilo, Roo Code, Aider, and Windows Trae.
-Detected integrations are preselected when recommended, undetected ones stay visible but cannot be selected,
-and you can toggle items with arrow keys plus `Enter` or by pressing their number.
+Each row includes a terminal-friendly icon plus the tool's official site, and you can toggle items with arrow keys plus `Enter` or by pressing their number.
 
 History notes:
 

package/dist/commands/setup.js

@@ -81,6 +81,49 @@ function hasCommand(name) {
     const result = (0, node_child_process_1.spawnSync)(lookupCommand, [name], { stdio: "ignore" });
     return result.status === 0;
 }
+function supportsTerminalHyperlinks() {
+    if (!process.stdout.isTTY)
+        return false;
+    if (process.env.FORCE_HYPERLINK === "1")
+        return true;
+    if (process.env.NO_HYPERLINK === "1")
+        return false;
+    const term = (process.env.TERM ?? "").toLowerCase();
+    if (!term || term === "dumb")
+        return false;
+    const termProgram = (process.env.TERM_PROGRAM ?? "").toLowerCase();
+    if (termProgram === "iterm.app" || termProgram === "wezterm" || termProgram === "vscode") {
+        return true;
+    }
+    if (process.env.WT_SESSION ||
+        process.env.KITTY_WINDOW_ID ||
+        process.env.KONSOLE_VERSION ||
+        process.env.VTE_VERSION ||
+        process.env.DOMTERM ||
+        process.env.TERMINAL_EMULATOR === "JetBrains-JediTerm") {
+        return true;
+    }
+    return term.includes("xterm-kitty") || term.includes("foot") || term.includes("wezterm");
+}
+function formatTerminalHyperlink(label, url) {
+    return `\u001B]8;;${url}\u0007${label}\u001B]8;;\u0007`;
+}
+function formatDim(value) {
+    return `\u001B[2m${value}\u001B[0m`;
+}
+function officialSiteLabel(siteUrl) {
+    const parsed = new URL(siteUrl);
+    const hostname = parsed.hostname.replace(/^www\./, "");
+    const pathname = parsed.pathname.replace(/\/+$/g, "");
+    return pathname && pathname !== "/" ? `${hostname}${pathname}` : hostname;
+}
+function formatSetupClientLabel(client, hyperlinksEnabled) {
+    const iconAndLabel = `${client.icon} ${client.label}`;
+    if (hyperlinksEnabled) {
+        return `${formatTerminalHyperlink(iconAndLabel, client.siteUrl)} ${formatDim(`(${officialSiteLabel(client.siteUrl)})`)}`;
+    }
+    return `${iconAndLabel} - ${client.siteUrl}`;
+}
 function localAppDataDir() {
     if (process.env.LOCALAPPDATA?.trim())
         return process.env.LOCALAPPDATA;
@@ -386,12 +429,13 @@ async function promptForSetupClients(clients) {
         let cursor = 0;
         let settled = false;
         let hint = clients.some((client) => client.detected)
-            ? "Detected integrations are preselected. Undetected ones stay visible but disabled."
-            : "No supported local clients are detected yet. Continue will just save your managed config and API key env.";
+            ? "Choose the tools you want to configure."
+            : "No supported local clients are detected yet. Apply setup will just save your managed config and API key env.";
         const stdin = process.stdin;
         const stdout = process.stdout;
         const wasRaw = stdin.isRaw;
-        const continueIndex = options.length;
+        const applyIndex = options.length;
+        const hyperlinksEnabled = supportsTerminalHyperlinks();
         const clearScreen = () => {
             stdout.write("\x1b[2J\x1b[H");
         };
@@ -400,15 +444,16 @@ async function promptForSetupClients(clients) {
             clearScreen();
             stdout.write("Choose local clients to configure\n");
             stdout.write(`Use ↑/↓ to move, Enter to toggle the highlighted integration, or press 1-${options.length} to toggle directly.\n`);
-            stdout.write("Move to Continue and press Enter when you're ready.\n\n");
+            stdout.write("Each tool name links to its official site when your terminal supports it.\n");
+            stdout.write("Move to Apply setup and press Enter when you're ready.\n\n");
             for (const [index, option] of options.entries()) {
                 const pointer = index === cursor ? ">" : " ";
                 const mark = option.detected ? (option.checked ? "[x]" : "[ ]") : "[-]";
                 const badge = option.detected ? (option.recommended ? "recommended" : "optional") : "not detected";
-                stdout.write(`${pointer} ${index + 1}. ${mark} ${option.label}  ${badge}\n`);
+                stdout.write(`${pointer} ${index + 1}. ${mark} ${formatSetupClientLabel(option, hyperlinksEnabled)}  ${badge}\n`);
             }
-            const continuePointer = cursor === continueIndex ? ">" : " ";
-            stdout.write(`${continuePointer} Continue with ${selectedCount()} selected integration${selectedCount() === 1 ? "" : "s"}\n`);
+            const applyPointer = cursor === applyIndex ? ">" : " ";
+            stdout.write(`${applyPointer} Apply setup with ${selectedCount()} selected integration${selectedCount() === 1 ? "" : "s"}\n`);
             stdout.write(`\n${hint}\n`);
         };
         const finish = () => {
@@ -454,7 +499,7 @@ async function promptForSetupClients(clients) {
                 return;
             }
             if (key.name === "space") {
-                if (cursor === continueIndex) {
+                if (cursor === applyIndex) {
                     finish();
                     return;
                 }
@@ -476,7 +521,7 @@ async function promptForSetupClients(clients) {
                 return;
             }
             if (key.name === "return" || key.name === "enter") {
-                if (cursor === continueIndex) {
+                if (cursor === applyIndex) {
                     finish();
                     return;
                 }
@@ -1126,54 +1171,72 @@ class SetupCommand extends base_command_1.BaseCommand {
                     label: "Codex CLI, VS Code extension, and Codex app",
                     detected: codexDetected,
                     recommended: true,
+                    icon: "◎",
+                    siteUrl: "https://openai.com/codex",
                 },
                 {
                     id: "continue",
                     label: "Continue",
                     detected: continueDetected,
                     recommended: true,
+                    icon: "▶",
+                    siteUrl: "https://continue.dev",
                 },
                 {
                     id: "cline",
                     label: "Cline",
                     detected: clineDetected,
                     recommended: true,
+                    icon: "◈",
+                    siteUrl: "https://cline.bot",
                 },
                 {
                     id: "openclaw",
                     label: "OpenClaw",
                     detected: hasCommand("openclaw"),
                     recommended: true,
+                    icon: "🦞",
+                    siteUrl: "https://openclaw.ai",
                 },
                 {
                     id: "opencode",
                     label: "OpenCode",
                     detected: hasCommand("opencode"),
                     recommended: true,
+                    icon: "⌘",
+                    siteUrl: "https://opencode.ai",
                 },
                 {
                     id: "kilo",
                     label: "Kilo Code",
                     detected: kiloDetected,
                     recommended: true,
+                    icon: "⚡",
+                    siteUrl: "https://kilo.ai",
                 },
                 {
                     id: "roo",
                     label: "Roo Code",
                     detected: rooDetected,
                     recommended: true,
+                    icon: "🦘",
+                    siteUrl: "https://roocode.com",
                 },
                 {
                     id: "trae",
                     label: "Trae (experimental)",
                     detected: traeDetected,
                     recommended: false,
+                    icon: "△",
+                    siteUrl: "https://www.trae.ai",
                 },
                 {
                     id: "aider",
                     label: "Aider",
                     detected: aiderDetected,
                     recommended: true,
+                    icon: "✦",
+                    siteUrl: "https://aider.chat",
                 },
             ];
             const selectedSetupClients = await resolveSetupClientSelection({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "theclawbay",
-  "version": "0.3.27",
+  "version": "0.3.28",
   "description": "CLI for connecting Codex, Continue, Cline, OpenClaw, OpenCode, Kilo, Roo Code, Aider, and experimental Trae to The Claw Bay.",
   "license": "MIT",
   "bin": {