@jobshimo/browser-link 0.0.1

package/dist/commands/about.js

@@ -0,0 +1,248 @@
+import { stdout } from 'node:process';
+import { ansi, clearScreen, hideCursor, readKey, renderBox, showCursor, } from './tty.js';
+export const I18N_ABOUT = {
+    en: {
+        title: 'browser-link — about',
+        whatItIs: [
+            `${ansi.bold}What is this?${ansi.reset}`,
+            '',
+            'browser-link is an MCP (Model Context Protocol) server. It lets',
+            'Claude Code observe and act on the Google Chrome tabs you explicitly',
+            'enable through a companion extension. It is split in two pieces:',
+            '  1) This Node binary, the MCP server Claude Code spawns over stdio.',
+            '  2) A small Chrome extension that you load manually. The extension',
+            '     stays inert on every tab until you press "Conectar" on it. You',
+            '     can enable as many tabs as you want, one by one. Tabs you do',
+            '     not connect remain invisible to the agent.',
+        ],
+        howItWorks: [
+            `${ansi.bold}How does it work?${ansi.reset}`,
+            '',
+            'The Node binary listens on 127.0.0.1:17529 (loopback only — never on a',
+            'public interface). Each tab where you press "Conectar" opens its own',
+            'WebSocket to that port and registers a tab_id. From that moment on,',
+            'the agent can call tools targeting that tab_id, and the server',
+            'forwards each request to the extension over the WebSocket.',
+            '',
+            `${ansi.bold}Process binding (zero-config defense)${ansi.reset}`,
+            '',
+            'Before accepting any WebSocket handshake, the server asks the OS',
+            'kernel which process opened the incoming TCP connection. Connections',
+            'whose owner is not a known Chromium-based browser binary (Chrome,',
+            'Edge, Brave, Vivaldi, Chromium) are rejected before any application',
+            'bytes are exchanged. This closes the "any local process can talk to',
+            'the bridge" vector without asking you to copy or paste tokens.',
+            '',
+            'It does NOT defend against malware that has already injected itself',
+            'inside Chrome (chrome.debugger from another extension, etc.). That',
+            'attacker already controls the browser directly and the bridge adds',
+            'no surface they did not already have.',
+        ],
+        bridgeTools: {
+            title: `${ansi.bold}Tools the agent gets over the bridge${ansi.reset}`,
+            items: [
+                '  browser.list_tabs        list connected tabs',
+                '  browser.ping             check the bridge to a tab',
+                '  browser.snapshot         dump title, url, text and interactive elements',
+                '  browser.navigate         change the tab URL',
+                '  browser.click            click an element by CSS selector',
+                '  browser.type             type into an input',
+                '  browser.evaluate         run JavaScript in the page context',
+                '  browser.console          recent console messages (rolling 200)',
+                '  browser.network          recent network requests (rolling 200)',
+                '  browser.network_body     fetch the body of a specific request',
+            ],
+        },
+        mapTools: {
+            title: `${ansi.bold}Persistent UI map (private, on your machine)${ansi.reset}`,
+            items: [
+                'The server keeps a small SQLite database with what the agent has',
+                'learned about each app it operates: stable selectors, multi-step',
+                'flows, and gotchas. Three kinds of entries (selector, flow, gotcha)',
+                'indexed by app + pathname. Tools the agent uses:',
+                '',
+                '  browser.map.recall       what do we know about this app/route?',
+                '  browser.map.save         persist a selector, flow, or gotcha',
+                '  browser.map.record_use   verified / failed timestamp per entry',
+                '  browser.map.forget       delete an entry or an entire app',
+                '  browser.map.rename_app   fix a bad app_key from the first save',
+                '  browser.map.apps         list known apps',
+            ],
+        },
+        privacy: [
+            `${ansi.bold}Where your data lives${ansi.reset}`,
+            '',
+            '  • The UI map is at:',
+            '      Linux    $XDG_DATA_HOME/browser-link/map.db',
+            '      macOS    ~/Library/Application Support/browser-link/map.db',
+            '      Windows  %APPDATA%/browser-link/map.db',
+            '    Override with BROWSER_LINK_DATA_DIR.',
+            '  • Nothing is uploaded anywhere by this package. The bridge only',
+            '    talks loopback to your local Chrome extension.',
+            '  • What you save in the map is your responsibility. Never save',
+            '    domain data (IDs, names, dates) — the map is for UI structure.',
+        ],
+        whereToGetHelp: [
+            `${ansi.bold}Get help / report issues${ansi.reset}`,
+            '',
+            '  GitHub  https://github.com/jobshimo/browser-link',
+            '  Issues  https://github.com/jobshimo/browser-link/issues',
+            '',
+            'Useful subcommands:',
+            '  browser-link doctor      diagnose what is and is not set up',
+            '  browser-link extension   show where the Chrome extension assets are',
+            '  browser-link install     register browser-link in your MCP client',
+            '  browser-link about       show this page',
+            '  browser-link help        list every subcommand',
+        ],
+        prompt: 'Press any key to return.',
+    },
+    es: {
+        title: 'browser-link — información',
+        whatItIs: [
+            `${ansi.bold}¿Qué es esto?${ansi.reset}`,
+            '',
+            'browser-link es un servidor MCP (Model Context Protocol). Permite que',
+            'Claude Code observe y actúe sobre las pestañas de Google Chrome a las',
+            'que vos le des acceso explícito mediante una extensión que acompaña',
+            'al paquete. Tiene dos piezas:',
+            '  1) Este binario de Node, el servidor MCP que Claude Code arranca',
+            '     por stdio.',
+            '  2) Una pequeña extensión de Chrome que cargás vos a mano. La',
+            '     extensión queda inerte en cada pestaña hasta que pulsás',
+            '     "Conectar" sobre ella. Podés habilitar todas las pestañas que',
+            '     quieras, una por una. Las pestañas que no conectes siguen',
+            '     invisibles al agente.',
+        ],
+        howItWorks: [
+            `${ansi.bold}¿Cómo funciona?${ansi.reset}`,
+            '',
+            'El binario de Node escucha en 127.0.0.1:17529 (solo loopback — nunca',
+            'en una interfaz pública). Cada pestaña donde pulsás "Conectar" abre',
+            'su propio WebSocket contra ese puerto y se registra con un tab_id.',
+            'Desde ahí, el agente puede llamar herramientas que apuntan a ese',
+            'tab_id y el servidor reenvía cada petición a la extensión.',
+            '',
+            `${ansi.bold}Validación por proceso (sin configuración)${ansi.reset}`,
+            '',
+            'Antes de aceptar cualquier handshake WebSocket, el servidor le',
+            'pregunta al kernel del SO qué proceso abrió la conexión TCP entrante.',
+            'Conexiones cuyo dueño no es un binario conocido de un navegador',
+            'Chromium-based (Chrome, Edge, Brave, Vivaldi, Chromium) se rechazan',
+            'antes de intercambiar bytes de aplicación. Eso cierra el vector "cualquier',
+            'proceso local puede hablar con el puente" sin pedirte copiar tokens.',
+            '',
+            'NO te protege contra malware que ya se inyectó dentro de Chrome',
+            '(chrome.debugger desde otra extensión maliciosa, etc.). Ese atacante',
+            'ya controla el navegador directamente y el puente no le suma',
+            'superficie nueva.',
+        ],
+        bridgeTools: {
+            title: `${ansi.bold}Herramientas que el agente expone vía el puente${ansi.reset}`,
+            items: [
+                '  browser.list_tabs        listar pestañas conectadas',
+                '  browser.ping             comprobar el puente a una pestaña',
+                '  browser.snapshot         volcar título, url, texto y elementos interactivos',
+                '  browser.navigate         cambiar la URL de la pestaña',
+                '  browser.click            hacer click en un elemento por CSS selector',
+                '  browser.type             escribir en un input',
+                '  browser.evaluate         ejecutar JavaScript en el contexto de la página',
+                '  browser.console          mensajes recientes de consola (200 últimos)',
+                '  browser.network          peticiones de red recientes (200 últimas)',
+                '  browser.network_body     traer el body de una petición concreta',
+            ],
+        },
+        mapTools: {
+            title: `${ansi.bold}Mapa de UI persistente (privado, en tu máquina)${ansi.reset}`,
+            items: [
+                'El servidor mantiene una pequeña base SQLite con lo que el agente',
+                'va aprendiendo de cada app: selectores estables, flujos de pasos y',
+                'gotchas. Tres tipos de entradas (selector, flow, gotcha) indexadas',
+                'por app + path. Herramientas que el agente usa:',
+                '',
+                '  browser.map.recall       ¿qué sabemos de esta app/ruta?',
+                '  browser.map.save         guardar un selector, flujo o gotcha',
+                '  browser.map.record_use   marcar verified / failed por entrada',
+                '  browser.map.forget       borrar una entrada o una app entera',
+                '  browser.map.rename_app   corregir un app_key mal derivado',
+                '  browser.map.apps         listar apps conocidas',
+            ],
+        },
+        privacy: [
+            `${ansi.bold}Dónde vive tu información${ansi.reset}`,
+            '',
+            '  • El mapa de UI está en:',
+            '      Linux    $XDG_DATA_HOME/browser-link/map.db',
+            '      macOS    ~/Library/Application Support/browser-link/map.db',
+            '      Windows  %APPDATA%/browser-link/map.db',
+            '    Sobreescribilo con BROWSER_LINK_DATA_DIR.',
+            '  • Este paquete no sube nada a ningún lado. El puente solo habla',
+            '    loopback con la extensión local de Chrome.',
+            '  • Lo que guardes en el mapa es responsabilidad tuya. No guardes',
+            '    datos de dominio (IDs, nombres, fechas) — el mapa es para',
+            '    estructura de UI, no para data.',
+        ],
+        whereToGetHelp: [
+            `${ansi.bold}Ayuda / reportar bugs${ansi.reset}`,
+            '',
+            '  GitHub  https://github.com/jobshimo/browser-link',
+            '  Issues  https://github.com/jobshimo/browser-link/issues',
+            '',
+            'Subcomandos útiles:',
+            '  browser-link doctor      diagnóstico de qué está y qué falta',
+            '  browser-link extension   ver dónde están los assets de la extensión',
+            '  browser-link install     registrar browser-link en tu cliente MCP',
+            '  browser-link about       mostrar esta página',
+            '  browser-link help        listar todos los subcomandos',
+        ],
+        prompt: 'Pulsá cualquier tecla para volver.',
+    },
+};
+export function buildAboutScreen(t) {
+    const lines = [];
+    lines.push(`${ansi.bold}${ansi.cyan}${t.title}${ansi.reset}`);
+    lines.push('');
+    for (const l of t.whatItIs)
+        lines.push(l);
+    lines.push('');
+    for (const l of t.howItWorks)
+        lines.push(l);
+    lines.push('');
+    lines.push(t.bridgeTools.title);
+    lines.push('');
+    for (const l of t.bridgeTools.items)
+        lines.push(l);
+    lines.push('');
+    lines.push(t.mapTools.title);
+    lines.push('');
+    for (const l of t.mapTools.items)
+        lines.push(l);
+    lines.push('');
+    for (const l of t.privacy)
+        lines.push(l);
+    lines.push('');
+    for (const l of t.whereToGetHelp)
+        lines.push(l);
+    return renderBox(lines, { borderColor: ansi.gray });
+}
+export async function runAbout(language = 'en') {
+    const t = I18N_ABOUT[language];
+    hideCursor();
+    try {
+        clearScreen();
+        stdout.write(buildAboutScreen(t));
+        stdout.write('\n\n');
+        stdout.write(`${ansi.dim}${t.prompt}${ansi.reset} `);
+        await readKey();
+    }
+    finally {
+        showCursor();
+        stdout.write('\n');
+    }
+}
+/** Plain-text render of About for non-interactive output (browser-link about). */
+export function printAbout(language = 'en') {
+    const t = I18N_ABOUT[language];
+    console.log(buildAboutScreen(t));
+}
+//# sourceMappingURL=about.js.map

package/dist/commands/about.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"about.js","sourceRoot":"","sources":["../../src/commands/about.ts"],"names":[],"mappings":"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"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,29 @@
+export interface DoctorReport {
+    ws: {
+        listening: boolean;
+        detail: string;
+        host: string;
+        port: number;
+    };
+    clients: {
+        id: string;
+        displayName: string;
+        installed: boolean;
+        registered: boolean;
+        configPath: string;
+    }[];
+    extension: {
+        path: string | null;
+    };
+    map: {
+        dbPath: string;
+        exists: boolean;
+        sizeBytes: number;
+        apps: number;
+    };
+    security: {
+        allowedBrowsers: readonly string[];
+    };
+}
+export declare function runDoctor(): Promise<DoctorReport>;
+export declare function formatDoctor(r: DoctorReport): string;

package/dist/commands/doctor.js

@@ -0,0 +1,110 @@
+import { existsSync, statSync } from 'node:fs';
+import { createConnection } from 'node:net';
+import { INSTALLERS } from '../installers/index.js';
+import { getAllowedBrowsers } from '../auth/allowlist.js';
+import { getDbPath } from '../map/paths.js';
+import { listApps } from '../map/queries.js';
+import { resolveExtensionPath } from './extension.js';
+const WS_HOST = '127.0.0.1';
+const WS_PORT = 17529;
+function checkPort(host, port, timeoutMs = 500) {
+    return new Promise((resolve) => {
+        const socket = createConnection({ host, port });
+        const settle = (listening, detail) => {
+            socket.removeAllListeners();
+            socket.destroy();
+            resolve({ listening, detail });
+        };
+        const timer = setTimeout(() => settle(false, `no response within ${timeoutMs}ms`), timeoutMs);
+        socket.once('connect', () => {
+            clearTimeout(timer);
+            settle(true, `something is listening on ${host}:${port}`);
+        });
+        socket.once('error', (err) => {
+            clearTimeout(timer);
+            if (err.code === 'ECONNREFUSED')
+                settle(false, 'no MCP server running');
+            else
+                settle(false, err.message);
+        });
+    });
+}
+export async function runDoctor() {
+    const ws = await checkPort(WS_HOST, WS_PORT);
+    const clients = INSTALLERS.map((i) => {
+        const d = i.detect();
+        return { id: i.id, displayName: i.displayName, ...d };
+    });
+    const extPath = resolveExtensionPath();
+    const dbPath = getDbPath();
+    const dbExists = existsSync(dbPath);
+    const sizeBytes = dbExists ? statSync(dbPath).size : 0;
+    let apps = 0;
+    if (dbExists) {
+        try {
+            apps = listApps().length;
+        }
+        catch {
+            apps = -1;
+        }
+    }
+    return {
+        ws: { ...ws, host: WS_HOST, port: WS_PORT },
+        clients,
+        extension: { path: extPath },
+        map: { dbPath, exists: dbExists, sizeBytes, apps },
+        security: { allowedBrowsers: getAllowedBrowsers() },
+    };
+}
+function symbol(ok) {
+    return ok ? '✓' : '✗';
+}
+export function formatDoctor(r) {
+    const lines = [];
+    lines.push('browser-link doctor');
+    lines.push('');
+    lines.push(`WebSocket bridge  ${symbol(r.ws.listening)} ${r.ws.host}:${r.ws.port} — ${r.ws.detail}`);
+    if (!r.ws.listening) {
+        lines.push('                   (the server is launched by your MCP client; open Claude Code / OpenCode to start it)');
+    }
+    lines.push('');
+    lines.push('MCP clients:');
+    for (const c of r.clients) {
+        const status = !c.installed
+            ? '✗ not installed'
+            : c.registered
+                ? '✓ registered'
+                : '⚠ installed but not registered';
+        lines.push(`  ${c.displayName.padEnd(14)} ${status}`);
+        lines.push(`  ${' '.repeat(14)} config: ${c.configPath}`);
+    }
+    lines.push('');
+    lines.push('Chrome extension assets:');
+    if (r.extension.path) {
+        lines.push(`  ${symbol(true)} ${r.extension.path}`);
+    }
+    else {
+        lines.push(`  ${symbol(false)} not found (run \`browser-link extension\` for guidance)`);
+    }
+    lines.push('');
+    lines.push('Map DB:');
+    lines.push(`  path: ${r.map.dbPath}`);
+    if (!r.map.exists) {
+        lines.push('  (not created yet — will be initialized on first run)');
+    }
+    else {
+        lines.push(`  size: ${r.map.sizeBytes} bytes`);
+        lines.push(`  apps tracked: ${r.map.apps}`);
+    }
+    lines.push('');
+    lines.push('Process binding:');
+    if (r.security.allowedBrowsers.length === 0) {
+        lines.push(`  ✗ no allowlist for this OS — incoming WS connections will be rejected.`);
+    }
+    else {
+        lines.push(`  ✓ accepts WS connections from ${r.security.allowedBrowsers.length} known browser binaries.`);
+        lines.push(`    (${r.security.allowedBrowsers.slice(0, 4).join(', ')}${r.security.allowedBrowsers.length > 4 ? ', …' : ''})`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/commands/extension.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolve the absolute path to the Chrome extension assets.
+ * Tries the npm-install layout first, then the monorepo dev layout.
+ * Returns null if neither has a manifest.json.
+ */
+export declare function resolveExtensionPath(): string | null;
+export interface ExtensionInfo {
+    path: string | null;
+    hints: string;
+}
+export declare function getExtensionInfo(): ExtensionInfo;
+export declare function printExtensionInstructions(): void;

package/dist/commands/extension.js

@@ -0,0 +1,76 @@
+import { existsSync } from 'node:fs';
+import { platform } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Resolve the absolute path to the Chrome extension assets.
+ * Tries the npm-install layout first, then the monorepo dev layout.
+ * Returns null if neither has a manifest.json.
+ */
+export function resolveExtensionPath() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        // npm package layout (extension bundled alongside server dist)
+        join(here, '..', 'extension'),
+        // monorepo dev layout (packages/server/dist/commands → packages/extension/dist)
+        resolve(here, '..', '..', '..', 'extension', 'dist'),
+        // monorepo dev layout when cli is at dist root (packages/server/dist → packages/extension/dist)
+        resolve(here, '..', '..', 'extension', 'dist'),
+    ];
+    for (const c of candidates) {
+        if (existsSync(join(c, 'manifest.json')))
+            return c;
+    }
+    return null;
+}
+function osHints(extPath) {
+    const p = platform();
+    if (p === 'win32') {
+        return [
+            'Open Chrome and go to: chrome://extensions',
+            'Toggle "Developer mode" (top-right).',
+            'Click "Load unpacked".',
+            `Browse to: ${extPath}`,
+            'Click "Select Folder".',
+        ].join('\n  ');
+    }
+    if (p === 'darwin') {
+        return [
+            'Open Chrome and go to: chrome://extensions',
+            'Toggle "Developer mode" (top-right).',
+            'Click "Load unpacked".',
+            `In the file picker, press ⌘⇧G and paste: ${extPath}`,
+            'Press Return, then "Select".',
+        ].join('\n  ');
+    }
+    return [
+        'Open Chrome and go to: chrome://extensions',
+        'Toggle "Developer mode" (top-right).',
+        'Click "Load unpacked".',
+        `Select the folder: ${extPath}`,
+    ].join('\n  ');
+}
+export function getExtensionInfo() {
+    const path = resolveExtensionPath();
+    return {
+        path,
+        hints: path
+            ? osHints(path)
+            : 'Extension assets not found. Run `npm run build:extension` (dev) or reinstall the package.',
+    };
+}
+export function printExtensionInstructions() {
+    const info = getExtensionInfo();
+    if (!info.path) {
+        console.log(info.hints);
+        return;
+    }
+    console.log('Chrome extension assets are at:');
+    console.log(`  ${info.path}`);
+    console.log('');
+    console.log('Install steps:');
+    console.log(`  ${info.hints}`);
+    console.log('');
+    console.log('After loading, open the extension popup on any tab and click "Conectar" to bridge it.');
+}
+//# sourceMappingURL=extension.js.map

package/dist/commands/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../src/commands/extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG;QACjB,+DAA+D;QAC/D,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC;QAC7B,gFAAgF;QAChF,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC;QACpD,gGAAgG;QAChG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC;KAC/C,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,OAAO,CAAC,OAAe;IAC9B,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;IACrB,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;QAClB,OAAO;YACL,4CAA4C;YAC5C,sCAAsC;YACtC,wBAAwB;YACxB,cAAc,OAAO,EAAE;YACvB,wBAAwB;SACzB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QACnB,OAAO;YACL,4CAA4C;YAC5C,sCAAsC;YACtC,wBAAwB;YACxB,4CAA4C,OAAO,EAAE;YACrD,8BAA8B;SAC/B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC;IACD,OAAO;QACL,4CAA4C;QAC5C,sCAAsC;QACtC,wBAAwB;QACxB,sBAAsB,OAAO,EAAE;KAChC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,CAAC;AAOD,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAC;IACpC,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,IAAI;YACT,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;YACf,CAAC,CAAC,2FAA2F;KAChG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CACT,uFAAuF,CACxF,CAAC;AACJ,CAAC"}

package/dist/commands/install.d.ts

@@ -0,0 +1,19 @@
+import { type ClientId } from '../installers/index.js';
+/**
+ * Same shape but using the absolute path to the compiled MCP entry — useful
+ * as a fallback when the bin is not yet on PATH (fresh clone, no `npm link`).
+ * The entry path is resolved at runtime by `entry-info.js` so this stays
+ * correct even if the dist layout changes.
+ */
+export declare function resolveAbsoluteServerCommand(): {
+    command: string;
+    args: string[];
+};
+export interface InstallReport {
+    client: ClientId;
+    displayName: string;
+    installedClient: boolean;
+    message: string;
+}
+export declare function installFor(client: ClientId, mode?: 'bin' | 'absolute'): InstallReport;
+export declare function installAll(mode?: 'bin' | 'absolute'): InstallReport[];

package/dist/commands/install.js

@@ -0,0 +1,52 @@
+import { existsSync } from 'node:fs';
+import { SERVER_ENTRY_PATH } from '../entry-info.js';
+import { INSTALLERS, getInstaller } from '../installers/index.js';
+/**
+ * Where this CLI lives on disk. Used to build the MCP command that clients
+ * must spawn. We prefer the bin name "browser-link" on PATH; if the user
+ * invoked us via an absolute path (e.g. unpublished dev install), we fall
+ * back to that absolute node command.
+ */
+function resolveServerCommand() {
+    // npm installs put `browser-link` on PATH. That's the most portable across OSes.
+    // For dev runs (no global install) the user can override via env var.
+    const override = process.env.BROWSER_LINK_BIN;
+    if (override) {
+        const parts = override.split(' ').filter(Boolean);
+        return { command: parts[0], args: parts.slice(1) };
+    }
+    // Default: rely on the PATH lookup. This works on Windows because npm
+    // creates a `browser-link.cmd` shim alongside the global node binary.
+    return { command: 'browser-link', args: [] };
+}
+/**
+ * Same shape but using the absolute path to the compiled MCP entry — useful
+ * as a fallback when the bin is not yet on PATH (fresh clone, no `npm link`).
+ * The entry path is resolved at runtime by `entry-info.js` so this stays
+ * correct even if the dist layout changes.
+ */
+export function resolveAbsoluteServerCommand() {
+    if (existsSync(SERVER_ENTRY_PATH)) {
+        return { command: process.execPath, args: [SERVER_ENTRY_PATH] };
+    }
+    return resolveServerCommand();
+}
+export function installFor(client, mode = 'bin') {
+    const inst = getInstaller(client);
+    const detect = inst.detect();
+    if (!detect.installed) {
+        return {
+            client,
+            displayName: inst.displayName,
+            installedClient: false,
+            message: `${inst.displayName} config not found at ${detect.configPath}. Install ${inst.displayName} first.`,
+        };
+    }
+    const cmd = mode === 'absolute' ? resolveAbsoluteServerCommand() : resolveServerCommand();
+    const message = inst.install(cmd.command, cmd.args);
+    return { client, displayName: inst.displayName, installedClient: true, message };
+}
+export function installAll(mode = 'bin') {
+    return INSTALLERS.map((i) => installFor(i.id, mode));
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAiB,MAAM,wBAAwB,CAAC;AAEjF;;;;;GAKG;AACH,SAAS,oBAAoB;IAC3B,iFAAiF;IACjF,sEAAsE;IACtE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC9C,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAClD,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,CAAC;IACD,sEAAsE;IACtE,sEAAsE;IACtE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B;IAC1C,IAAI,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;IAClE,CAAC;IACD,OAAO,oBAAoB,EAAE,CAAC;AAChC,CAAC;AASD,MAAM,UAAU,UAAU,CAAC,MAAgB,EAAE,OAA2B,KAAK;IAC3E,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO;YACL,MAAM;YACN,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,eAAe,EAAE,KAAK;YACtB,OAAO,EAAE,GAAG,IAAI,CAAC,WAAW,wBAAwB,MAAM,CAAC,UAAU,aAAa,IAAI,CAAC,WAAW,SAAS;SAC5G,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,4BAA4B,EAAE,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC;IAC1F,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACpD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAA2B,KAAK;IACzD,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/commands/menu.d.ts

@@ -0,0 +1,26 @@
+import { type Language } from './welcome.js';
+interface MenuI18n {
+    title: string;
+    prompt: string;
+    pressEnter: string;
+    options: {
+        register: string;
+        extension: string;
+        doctor: string;
+        welcome: string;
+        about: string;
+        repo: string;
+        quit: string;
+    };
+    statusRegistered: string;
+    statusNotRegistered: string;
+    statusClientMissing: string;
+    registerSuccessHint: string;
+    repoOpened: string;
+    repoFallback: string;
+}
+export declare const I18N_MENU: Record<Language, MenuI18n>;
+export declare function claudeStatus(t: MenuI18n): string;
+export declare function renderMenuScreen(t: MenuI18n, selectedIndex: number, options: string[]): string;
+export declare function runMenu(initialLanguage?: Language): Promise<void>;
+export {};