tabctl 0.1.4 → 0.2.1

package/{cli/lib/commands/meta.js → dist/cli/lib/commands/setup.js}

@@ -1,19 +1,19 @@
 "use strict";
 /**
- * Meta command handlers: version, ping, setup, skill, policy, history, undo
- * These commands don't operate on tab data and are relatively self-contained.
+ * Setup command handler: interactive browser profile configuration.
+ * Extracted from meta.ts for modularity.
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveBrowser = resolveBrowser;
+exports.resolveExtensionId = resolveExtensionId;
+exports.promptExtensionId = promptExtensionId;
+exports.resolveNodePath = resolveNodePath;
+exports.resolveManifestDir = resolveManifestDir;
+exports.writeWrapper = writeWrapper;
 exports.runSetup = runSetup;
-exports.runSkillInstall = runSkillInstall;
-exports.runVersion = runVersion;
-exports.runPolicy = runPolicy;
-exports.runHistory = runHistory;
-exports.runUndo = runUndo;
-exports.runPing = runPing;
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
@@ -21,13 +21,9 @@ const readline_1 = __importDefault(require("readline"));
 const node_child_process_1 = require("node:child_process");
 const constants_1 = require("../constants");
 const output_1 = require("../output");
-const client_1 = require("../client");
-const policy_1 = require("../policy");
 const profiles_1 = require("../../../shared/profiles");
+const config_1 = require("../../../shared/config");
 const extension_sync_1 = require("../../../shared/extension-sync");
-// ============================================================================
-// Setup Command
-// ============================================================================
 function resolveBrowser(value) {
     if (typeof value !== "string") {
         return null;
@@ -263,6 +259,9 @@ async function runSetup(options, prettyOutput) {
         profileEntry.userDataDir = userDataDir;
     }
     const registry = (0, profiles_1.addProfile)(profileName, profileEntry);
+    // Ensure printJson footer reflects the newly-created profile
+    (0, config_1.resetConfig)();
+    process.env.TABCTL_PROFILE = profileName;
     (0, output_1.printJson)({
         ok: true,
         action: "setup",
@@ -281,213 +280,18 @@ async function runSetup(options, prettyOutput) {
             extensionSynced: extensionSync?.synced || false,
         },
     }, prettyOutput);
-}
-// ============================================================================
-// Skill Command
-// ============================================================================
-function formatCliArgValue(value) {
-    const raw = String(value);
-    if (!raw) {
-        return raw;
-    }
-    if (/[\s"]/g.test(raw)) {
-        const escaped = raw.replace(/"/g, "\\\"");
-        return `"${escaped}"`;
-    }
-    return raw;
-}
-function resolveProjectRoot() {
-    try {
-        return fs_1.default.realpathSync(process.cwd());
-    }
-    catch {
-        return path_1.default.resolve(process.cwd());
-    }
-}
-function resolveConfigHome() {
-    return process.env.XDG_CONFIG_HOME || path_1.default.join(os_1.default.homedir(), ".config");
-}
-function resolveSkillTargetDir(globalInstall) {
-    if (globalInstall) {
-        return path_1.default.join(resolveConfigHome(), "opencode", "skills", constants_1.SKILL_NAME);
-    }
-    return path_1.default.join(resolveProjectRoot(), ".opencode", "skills", constants_1.SKILL_NAME);
-}
-function runSkillsCli(args) {
-    const result = (0, node_child_process_1.spawnSync)("npx", ["skills", ...args], { stdio: "pipe" });
-    if (result.error) {
-        (0, output_1.errorOut)(`Failed to run skills CLI: ${result.error.message}`);
-    }
-    if (typeof result.status === "number" && result.status !== 0) {
-        const stderr = result.stderr ? result.stderr.toString().trim() : "";
-        const stdout = result.stdout ? result.stdout.toString().trim() : "";
-        const detail = stderr || stdout;
-        const message = detail ? `skills CLI failed: ${detail}` : `skills CLI exited with status ${result.status}`;
-        (0, output_1.errorOut)(message);
-    }
-}
-function runSkillInstall(options, prettyOutput) {
-    const globalInstall = options.global === true;
-    const installTarget = resolveSkillTargetDir(globalInstall);
-    const agents = Array.isArray(options.agent)
-        ? options.agent.filter((value) => typeof value === "string" && value.trim())
-        : [];
-    const args = ["add", constants_1.SKILL_REPO, "--skill", constants_1.SKILL_NAME];
-    if (agents.length > 0) {
-        for (const agent of agents) {
-            args.push("-a", agent);
-        }
-    }
-    if (globalInstall) {
-        args.push("-g");
-    }
-    const hintAgents = agents.length > 0 ? agents.map((agent) => `-a ${formatCliArgValue(agent)}`).join(" ") : "";
-    const installHintParts = ["npx skills add", formatCliArgValue(constants_1.SKILL_REPO), "--skill", constants_1.SKILL_NAME];
-    if (hintAgents) {
-        installHintParts.push(hintAgents);
-    }
-    if (globalInstall) {
-        installHintParts.push("-g");
-    }
-    const installHint = installHintParts.join(" ").trim();
-    runSkillsCli(args);
-    (0, output_1.printJson)({
-        ok: true,
-        data: {
-            name: constants_1.SKILL_NAME,
-            targetDir: installTarget,
-            scope: globalInstall ? "global" : "project",
-            installHint,
-            tool: "skills",
-        },
-    }, prettyOutput);
-}
-// ============================================================================
-// Version Command
-// ============================================================================
-function runVersion(prettyOutput) {
-    (0, output_1.printJson)({
-        ok: true,
-        data: {
-            version: constants_1.VERSION,
-            baseVersion: constants_1.BASE_VERSION,
-            gitSha: constants_1.GIT_SHA,
-            dirty: constants_1.DIRTY,
-            component: "cli",
-        },
-    }, prettyOutput);
-}
-// ============================================================================
-// Policy Command
-// ============================================================================
-function runPolicy(options, policyContext, prettyOutput) {
-    const policyPath = (0, policy_1.defaultPolicyPath)();
-    if (options.init) {
-        if (fs_1.default.existsSync(policyPath)) {
-            (0, output_1.printJson)({
-                ok: true,
-                data: {
-                    status: "exists",
-                    path: policyPath,
-                },
-            }, prettyOutput);
-            return;
-        }
-        const dir = path_1.default.dirname(policyPath);
-        fs_1.default.mkdirSync(dir, { recursive: true });
-        fs_1.default.writeFileSync(policyPath, JSON.stringify((0, policy_1.defaultPolicyTemplate)(), null, 2), "utf8");
-        (0, output_1.printJson)({
-            ok: true,
-            data: {
-                status: "created",
-                path: policyPath,
-            },
-        }, prettyOutput);
-        return;
-    }
-    const policySummary = (0, policy_1.summarizePolicy)(policyContext.policy, policyContext.path);
-    (0, output_1.printJson)({
-        ok: true,
-        data: {
-            ...policySummary,
-            path: policyPath,
-        },
-    }, prettyOutput);
-}
-// ============================================================================
-// History Command
-// ============================================================================
-async function runHistory(options, prettyOutput) {
-    const params = {
-        limit: options.limit ? Number(options.limit) : undefined,
-    };
-    const response = await (0, client_1.sendRequest)({
-        id: (0, client_1.createRequestId)(),
-        action: "history",
-        params,
-        client: {
-            component: "cli",
-            version: constants_1.VERSION,
-            baseVersion: constants_1.BASE_VERSION,
-            gitSha: constants_1.GIT_SHA,
-            dirty: constants_1.DIRTY,
-        },
-    });
-    (0, output_1.printJson)(response, prettyOutput);
-    if (!response.ok) {
-        process.exit(1);
-    }
-}
-// ============================================================================
-// Undo Command
-// ============================================================================
-async function runUndo(options, prettyOutput) {
-    const positionalTxid = options._[0];
-    const flagTxid = options.txid;
-    const useLatest = options.latest === true;
-    if (useLatest && (positionalTxid || flagTxid)) {
-        (0, output_1.errorOut)("--latest cannot be combined with a txid argument or --txid");
-    }
-    const txid = positionalTxid || flagTxid;
-    const params = {
-        txid,
-        latest: useLatest,
-    };
-    const response = await (0, client_1.sendRequest)({
-        id: (0, client_1.createRequestId)(),
-        action: "undo",
-        params,
-        client: {
-            component: "cli",
-            version: constants_1.VERSION,
-            baseVersion: constants_1.BASE_VERSION,
-            gitSha: constants_1.GIT_SHA,
-            dirty: constants_1.DIRTY,
-        },
-    });
-    (0, output_1.printJson)(response, prettyOutput);
-    if (!response.ok) {
-        process.exit(1);
-    }
-}
-// ============================================================================
-// Ping Command
-// ============================================================================
-async function runPing(prettyOutput) {
-    const response = await (0, client_1.sendRequest)({
-        id: (0, client_1.createRequestId)(),
-        action: "ping",
-        params: {},
-        client: {
-            component: "cli",
-            version: constants_1.VERSION,
-            baseVersion: constants_1.BASE_VERSION,
-            gitSha: constants_1.GIT_SHA,
-            dirty: constants_1.DIRTY,
-        },
-    });
-    (0, output_1.printJson)(response, prettyOutput);
-    if (!response.ok) {
-        process.exit(1);
-    }
+    if (registry.default !== profileName) {
+        process.stderr.write([
+            "",
+            `Profile "${profileName}" created (current default: "${registry.default}").`,
+            `  To use:          tabctl --profile ${profileName} <command>`,
+            `  To make default: tabctl profile-switch ${profileName}`,
+            "",
+        ].join("\n"));
+    }
+    process.stderr.write([
+        `Verify connection: tabctl --profile ${profileName} ping`,
+        `If ping fails, ensure the ${browser === "edge" ? "Edge" : "Chrome"} extension is active.`,
+        "",
+    ].join("\n"));
 }

package/{cli/lib/options.js → dist/cli/lib/options-commands.js}

@@ -1,61 +1,7 @@
 "use strict";
-/**
- * Central source of truth for CLI options and command metadata.
- * This eliminates duplication between argument parsing and help display.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.COMMANDS = exports.SCREENSHOT_OPTIONS = exports.OPTION_GROUPS = void 0;
-exports.getBooleanFlags = getBooleanFlags;
-exports.getAllowedFlags = getAllowedFlags;
-exports.getCommandAllowedFlags = getCommandAllowedFlags;
-exports.getCommandGroups = getCommandGroups;
-exports.getCommandOptions = getCommandOptions;
-exports.commandSupportsGroup = commandSupportsGroup;
-const GLOBAL_FLAGS = ["help", "json", "pretty"];
-// ============================================================================
-// Option Group Definitions
-// ============================================================================
-exports.OPTION_GROUPS = {
-    scope: {
-        name: "Scope Options",
-        description: "Filter which tabs/groups to operate on",
-        options: [
-            { flag: "--tab <id>", desc: "Target specific tab(s) by ID", repeatable: true },
-            { flag: "--group <name>", desc: "Target tabs in group by title" },
-            { flag: "--group-id <id>", desc: "Target group by ID (use -1 for ungrouped)" },
-            { flag: "--ungrouped", desc: "Alias for --group-id -1" },
-            { flag: "--window <id|active|last-focused>", desc: "Target tabs in specific window" },
-            { flag: "--all", desc: "Target all eligible tabs" },
-        ],
-    },
-    pagination: {
-        name: "Pagination Options",
-        description: "Control result paging (default limit: 100)",
-        options: [
-            { flag: "--limit <n>", desc: "Maximum items to return" },
-            { flag: "--offset <n>", desc: "Skip first n items" },
-            { flag: "--no-page", desc: "Disable pagination, return all results" },
-        ],
-    },
-};
-exports.SCREENSHOT_OPTIONS = {
-    name: "Screenshot Options",
-    description: "Control screenshot capture",
-    options: [
-        { flag: "--mode viewport|full", desc: "Capture mode" },
-        { flag: "--format png|jpeg", desc: "Image format" },
-        { flag: "--quality <n>", desc: "JPEG quality (0-100)" },
-        { flag: "--tile-max-dim <px>", desc: "Max tile dimension in pixels" },
-        { flag: "--max-bytes <n>", desc: "Max bytes per tile" },
-        { flag: "--wait-for load|dom|settle|none", desc: "Wait for page readiness before capture" },
-        { flag: "--wait-timeout-ms <ms>", desc: "Timeout for page readiness wait" },
-        { flag: "--out <dir>", desc: "Write files to directory" },
-        { flag: "--progress", desc: "Show progress during capture" },
-    ],
-};
-// ============================================================================
-// Command Metadata
-// ============================================================================
+exports.COMMANDS = void 0;
+const options_groups_1 = require("./options-groups");
 exports.COMMANDS = {
     help: {
         description: "Show help information",
@@ -111,7 +57,7 @@ exports.COMMANDS = {
     screenshot: {
         description: "Capture screenshots from tabs",
         groups: ["scope"],
-        options: exports.SCREENSHOT_OPTIONS.options,
+        options: options_groups_1.SCREENSHOT_OPTIONS.options,
     },
     focus: {
         description: "Focus a specific tab",
@@ -308,101 +254,3 @@ exports.COMMANDS = {
         description: "Test connection to browser extension",
     },
 };
-// ============================================================================
-// Helper Functions
-// ============================================================================
-/**
- * Get all allowed flags for argument parsing validation.
- */
-function getBooleanFlags() {
-    const flags = new Set();
-    GLOBAL_FLAGS.forEach((flag) => flags.add(flag));
-    const addFromOptions = (options) => {
-        for (const opt of options) {
-            if (!/^--[a-z-]+$/.test(opt.flag.trim())) {
-                continue;
-            }
-            const match = opt.flag.match(/^--([a-z-]+)/);
-            if (match) {
-                flags.add(match[1]);
-            }
-        }
-    };
-    for (const group of Object.values(exports.OPTION_GROUPS)) {
-        addFromOptions(group.options);
-    }
-    for (const cmd of Object.values(exports.COMMANDS)) {
-        if (cmd.options) {
-            addFromOptions(cmd.options);
-        }
-    }
-    return flags;
-}
-function getAllowedFlags() {
-    const flags = new Set();
-    for (const flag of getBooleanFlags()) {
-        flags.add(flag);
-    }
-    // Add value flags from option groups
-    for (const group of Object.values(exports.OPTION_GROUPS)) {
-        for (const opt of group.options) {
-            const match = opt.flag.match(/^--([a-z-]+)/);
-            if (match)
-                flags.add(match[1]);
-        }
-    }
-    // Add value flags from command options
-    for (const cmd of Object.values(exports.COMMANDS)) {
-        for (const opt of cmd.options || []) {
-            const match = opt.flag.match(/^--([a-z-]+)/);
-            if (match)
-                flags.add(match[1]);
-        }
-    }
-    flags.add("profile");
-    return flags;
-}
-function getCommandAllowedFlags(command) {
-    const flags = new Set(GLOBAL_FLAGS);
-    flags.add("profile");
-    const meta = exports.COMMANDS[command];
-    const addOptions = (options) => {
-        if (!options) {
-            return;
-        }
-        for (const opt of options) {
-            const match = opt.flag.match(/^--([a-z-]+)/);
-            if (match) {
-                flags.add(match[1]);
-            }
-        }
-    };
-    if (meta?.groups) {
-        for (const groupKey of meta.groups) {
-            addOptions(exports.OPTION_GROUPS[groupKey]?.options);
-        }
-    }
-    addOptions(meta?.options);
-    return flags;
-}
-/**
- * Get the option groups for a command.
- */
-function getCommandGroups(command) {
-    const meta = exports.COMMANDS[command];
-    return meta?.groups ? [...meta.groups] : [];
-}
-/**
- * Get command-specific options (not from groups).
- */
-function getCommandOptions(command) {
-    const meta = exports.COMMANDS[command];
-    return meta?.options ? [...meta.options] : [];
-}
-/**
- * Check if a command supports a specific option group.
- */
-function commandSupportsGroup(command, group) {
-    const meta = exports.COMMANDS[command];
-    return meta?.groups?.includes(group) ?? false;
-}

package/dist/cli/lib/options-groups.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCREENSHOT_OPTIONS = exports.OPTION_GROUPS = void 0;
+exports.OPTION_GROUPS = {
+    scope: {
+        name: "Scope Options",
+        description: "Filter which tabs/groups to operate on",
+        options: [
+            { flag: "--tab <id>", desc: "Target specific tab(s) by ID", repeatable: true },
+            { flag: "--group <name>", desc: "Target tabs in group by title" },
+            { flag: "--group-id <id>", desc: "Target group by ID (use -1 for ungrouped)" },
+            { flag: "--ungrouped", desc: "Alias for --group-id -1" },
+            { flag: "--window <id|active|last-focused>", desc: "Target tabs in specific window" },
+            { flag: "--all", desc: "Target all eligible tabs" },
+        ],
+    },
+    pagination: {
+        name: "Pagination Options",
+        description: "Control result paging (default limit: 100)",
+        options: [
+            { flag: "--limit <n>", desc: "Maximum items to return" },
+            { flag: "--offset <n>", desc: "Skip first n items" },
+            { flag: "--no-page", desc: "Disable pagination, return all results" },
+        ],
+    },
+};
+exports.SCREENSHOT_OPTIONS = {
+    name: "Screenshot Options",
+    description: "Control screenshot capture",
+    options: [
+        { flag: "--mode viewport|full", desc: "Capture mode" },
+        { flag: "--format png|jpeg", desc: "Image format" },
+        { flag: "--quality <n>", desc: "JPEG quality (0-100)" },
+        { flag: "--tile-max-dim <px>", desc: "Max tile dimension in pixels" },
+        { flag: "--max-bytes <n>", desc: "Max bytes per tile" },
+        { flag: "--wait-for load|dom|settle|none", desc: "Wait for page readiness before capture" },
+        { flag: "--wait-timeout-ms <ms>", desc: "Timeout for page readiness wait" },
+        { flag: "--out <dir>", desc: "Write files to directory" },
+        { flag: "--progress", desc: "Show progress during capture" },
+    ],
+};

package/dist/cli/lib/options.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * Central source of truth for CLI options and command metadata.
+ * This eliminates duplication between argument parsing and help display.
+ *
+ * Data definitions live in options-commands.ts and options-groups.ts;
+ * this module re-exports them and provides validation helpers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMANDS = exports.SCREENSHOT_OPTIONS = exports.OPTION_GROUPS = void 0;
+exports.getBooleanFlags = getBooleanFlags;
+exports.getAllowedFlags = getAllowedFlags;
+exports.getCommandAllowedFlags = getCommandAllowedFlags;
+exports.getCommandGroups = getCommandGroups;
+exports.getCommandOptions = getCommandOptions;
+exports.commandSupportsGroup = commandSupportsGroup;
+// ============================================================================
+// Re-exports from split modules
+// ============================================================================
+var options_groups_1 = require("./options-groups");
+Object.defineProperty(exports, "OPTION_GROUPS", { enumerable: true, get: function () { return options_groups_1.OPTION_GROUPS; } });
+Object.defineProperty(exports, "SCREENSHOT_OPTIONS", { enumerable: true, get: function () { return options_groups_1.SCREENSHOT_OPTIONS; } });
+var options_commands_1 = require("./options-commands");
+Object.defineProperty(exports, "COMMANDS", { enumerable: true, get: function () { return options_commands_1.COMMANDS; } });
+const options_groups_2 = require("./options-groups");
+const options_commands_2 = require("./options-commands");
+const GLOBAL_FLAGS = ["help", "json", "pretty"];
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Get all allowed flags for argument parsing validation.
+ */
+function getBooleanFlags() {
+    const flags = new Set();
+    GLOBAL_FLAGS.forEach((flag) => flags.add(flag));
+    const addFromOptions = (options) => {
+        for (const opt of options) {
+            if (!/^--[a-z-]+$/.test(opt.flag.trim())) {
+                continue;
+            }
+            const match = opt.flag.match(/^--([a-z-]+)/);
+            if (match) {
+                flags.add(match[1]);
+            }
+        }
+    };
+    for (const group of Object.values(options_groups_2.OPTION_GROUPS)) {
+        addFromOptions(group.options);
+    }
+    for (const cmd of Object.values(options_commands_2.COMMANDS)) {
+        if (cmd.options) {
+            addFromOptions(cmd.options);
+        }
+    }
+    return flags;
+}
+function getAllowedFlags() {
+    const flags = new Set();
+    for (const flag of getBooleanFlags()) {
+        flags.add(flag);
+    }
+    // Add value flags from option groups
+    for (const group of Object.values(options_groups_2.OPTION_GROUPS)) {
+        for (const opt of group.options) {
+            const match = opt.flag.match(/^--([a-z-]+)/);
+            if (match)
+                flags.add(match[1]);
+        }
+    }
+    // Add value flags from command options
+    for (const cmd of Object.values(options_commands_2.COMMANDS)) {
+        for (const opt of cmd.options || []) {
+            const match = opt.flag.match(/^--([a-z-]+)/);
+            if (match)
+                flags.add(match[1]);
+        }
+    }
+    flags.add("profile");
+    return flags;
+}
+function getCommandAllowedFlags(command) {
+    const flags = new Set(GLOBAL_FLAGS);
+    flags.add("profile");
+    const meta = options_commands_2.COMMANDS[command];
+    const addOptions = (options) => {
+        if (!options) {
+            return;
+        }
+        for (const opt of options) {
+            const match = opt.flag.match(/^--([a-z-]+)/);
+            if (match) {
+                flags.add(match[1]);
+            }
+        }
+    };
+    if (meta?.groups) {
+        for (const groupKey of meta.groups) {
+            addOptions(options_groups_2.OPTION_GROUPS[groupKey]?.options);
+        }
+    }
+    addOptions(meta?.options);
+    return flags;
+}
+/**
+ * Get the option groups for a command.
+ */
+function getCommandGroups(command) {
+    const meta = options_commands_2.COMMANDS[command];
+    return meta?.groups ? [...meta.groups] : [];
+}
+/**
+ * Get command-specific options (not from groups).
+ */
+function getCommandOptions(command) {
+    const meta = options_commands_2.COMMANDS[command];
+    return meta?.options ? [...meta.options] : [];
+}
+/**
+ * Check if a command supports a specific option group.
+ */
+function commandSupportsGroup(command, group) {
+    const meta = options_commands_2.COMMANDS[command];
+    return meta?.groups?.includes(group) ?? false;
+}

package/{cli → dist/cli}/lib/output.js

@@ -23,8 +23,9 @@ function printJson(payload, pretty = true) {
 function errorOut(message) {
     const hints = {
         "Unknown option: --format": "Use --json for JSON output. --format is only for report.",
+        "ENOENT": "Native host not running. Ensure the browser extension is loaded and active. If you recently upgraded, run: tabctl setup",
     };
-    const hint = hints[message];
+    const hint = Object.entries(hints).find(([key]) => message.includes(key))?.[1];
     if (hint) {
         printJson({ ok: false, error: { message, hint } });
     }
@@ -45,13 +46,13 @@ function setupStdoutErrorHandling() {
 function emitVersionWarnings(response, fallbackAction) {
     const hostVersion = typeof response.version === "string" ? response.version : null;
     if (hostVersion && hostVersion !== version_1.VERSION) {
-        process.stderr.write(`[tabctl] version mismatch: cli ${version_1.VERSION}, host ${hostVersion}\n`);
+        process.stderr.write(`[tabctl] version mismatch: cli ${version_1.VERSION}, host ${hostVersion}. Run: tabctl setup\n`);
     }
     const data = response.data;
     const extensionVersion = data && typeof data.extensionVersion === "string" ? data.extensionVersion : null;
     const extensionComponent = data && typeof data.extensionComponent === "string" ? data.extensionComponent : null;
     if (extensionVersion && hostVersion && extensionVersion !== hostVersion) {
-        process.stderr.write(`[tabctl] version mismatch: host ${hostVersion}, extension ${extensionVersion}\n`);
+        process.stderr.write(`[tabctl] version mismatch: host ${hostVersion}, extension ${extensionVersion}. Reload the extension in your browser\n`);
     }
     if (extensionComponent && extensionComponent !== "extension") {
         process.stderr.write(`[tabctl] unexpected extension component: ${extensionComponent}\n`);
@@ -59,6 +60,6 @@ function emitVersionWarnings(response, fallbackAction) {
     const action = response.action || fallbackAction;
     const extensionExpected = !["history", "version"].includes(action);
     if (extensionExpected && !extensionVersion) {
-        process.stderr.write("[tabctl] extension version unavailable; reload the extension to validate version match\n");
+        process.stderr.write("[tabctl] extension version unavailable. Reload the extension in your browser\n");
     }
 }