@jackwener/opencli 0.9.8 → 1.0.0

package/dist/doctor.test.js

@@ -1,191 +1,51 @@
 import { describe, expect, it } from 'vitest';
-import { readTokenFromShellContent, renderBrowserDoctorReport, upsertShellToken, readTomlConfigToken, upsertTomlConfigToken, upsertJsonConfigToken, } from './doctor.js';
-describe('shell token helpers', () => {
-    it('reads token from shell export', () => {
-        expect(readTokenFromShellContent('export PLAYWRIGHT_MCP_EXTENSION_TOKEN="abc123"\n')).toBe('abc123');
-    });
-    it('appends token export when missing', () => {
-        const next = upsertShellToken('export PATH="/usr/bin"\n', 'abc123');
-        expect(next).toContain('export PLAYWRIGHT_MCP_EXTENSION_TOKEN="abc123"');
-    });
-    it('replaces token export when present', () => {
-        const next = upsertShellToken('export PLAYWRIGHT_MCP_EXTENSION_TOKEN="old"\n', 'new');
-        expect(next).toContain('export PLAYWRIGHT_MCP_EXTENSION_TOKEN="new"');
-        expect(next).not.toContain('"old"');
-    });
-});
-describe('toml token helpers', () => {
-    it('reads token from playwright env section', () => {
-        const content = `
-[mcp_servers.playwright.env]
-PLAYWRIGHT_MCP_EXTENSION_TOKEN = "abc123"
-`;
-        expect(readTomlConfigToken(content)).toBe('abc123');
-    });
-    it('updates token inside existing env section', () => {
-        const content = `
-[mcp_servers.playwright.env]
-PLAYWRIGHT_MCP_EXTENSION_TOKEN = "old"
-`;
-        const next = upsertTomlConfigToken(content, 'new');
-        expect(next).toContain('PLAYWRIGHT_MCP_EXTENSION_TOKEN = "new"');
-        expect(next).not.toContain('"old"');
-    });
-    it('creates env section when missing', () => {
-        const content = `
-[mcp_servers.playwright]
-type = "stdio"
-`;
-        const next = upsertTomlConfigToken(content, 'abc123');
-        expect(next).toContain('[mcp_servers.playwright.env]');
-        expect(next).toContain('PLAYWRIGHT_MCP_EXTENSION_TOKEN = "abc123"');
-    });
-});
-describe('json token helpers', () => {
-    it('writes token into standard mcpServers config', () => {
-        const next = upsertJsonConfigToken(JSON.stringify({
-            mcpServers: {
-                playwright: {
-                    command: 'npx',
-                    args: ['-y', '@playwright/mcp@latest', '--extension'],
-                },
-            },
-        }), 'abc123');
-        const parsed = JSON.parse(next);
-        expect(parsed.mcpServers.playwright.env.PLAYWRIGHT_MCP_EXTENSION_TOKEN).toBe('abc123');
-    });
-    it('writes token into opencode mcp config', () => {
-        const next = upsertJsonConfigToken(JSON.stringify({
-            $schema: 'https://opencode.ai/config.json',
-            mcp: {
-                playwright: {
-                    command: ['npx', '-y', '@playwright/mcp@latest', '--extension'],
-                    enabled: true,
-                    type: 'local',
-                },
-            },
-        }), 'abc123');
-        const parsed = JSON.parse(next);
-        expect(parsed.mcp.playwright.environment.PLAYWRIGHT_MCP_EXTENSION_TOKEN).toBe('abc123');
-    });
-    it('creates standard mcpServers format for empty file (not OpenCode)', () => {
-        const next = upsertJsonConfigToken('', 'abc123');
-        const parsed = JSON.parse(next);
-        expect(parsed.mcpServers.playwright.env.PLAYWRIGHT_MCP_EXTENSION_TOKEN).toBe('abc123');
-        expect(parsed.mcp).toBeUndefined();
-    });
-    it('creates OpenCode format when filePath contains opencode', () => {
-        const next = upsertJsonConfigToken('', 'abc123', '/home/user/.config/opencode/opencode.json');
-        const parsed = JSON.parse(next);
-        expect(parsed.mcp.playwright.environment.PLAYWRIGHT_MCP_EXTENSION_TOKEN).toBe('abc123');
-        expect(parsed.mcpServers).toBeUndefined();
-    });
-    it('creates standard format when filePath is claude.json', () => {
-        const next = upsertJsonConfigToken('', 'abc123', '/home/user/.claude.json');
-        const parsed = JSON.parse(next);
-        expect(parsed.mcpServers.playwright.env.PLAYWRIGHT_MCP_EXTENSION_TOKEN).toBe('abc123');
-    });
-});
-describe('fish shell support', () => {
-    it('generates fish set -gx syntax for fish config path', () => {
-        const next = upsertShellToken('', 'abc123', '/home/user/.config/fish/config.fish');
-        expect(next).toContain('set -gx PLAYWRIGHT_MCP_EXTENSION_TOKEN "abc123"');
-        expect(next).not.toContain('export');
-    });
-    it('replaces existing fish set line', () => {
-        const content = 'set -gx PLAYWRIGHT_MCP_EXTENSION_TOKEN "old"\n';
-        const next = upsertShellToken(content, 'new', '/home/user/.config/fish/config.fish');
-        expect(next).toContain('set -gx PLAYWRIGHT_MCP_EXTENSION_TOKEN "new"');
-        expect(next).not.toContain('"old"');
-    });
-    it('appends fish syntax to existing fish config', () => {
-        const content = 'set -gx PATH /usr/bin\n';
-        const next = upsertShellToken(content, 'abc123', '/home/user/.config/fish/config.fish');
-        expect(next).toContain('set -gx PLAYWRIGHT_MCP_EXTENSION_TOKEN "abc123"');
-        expect(next).toContain('set -gx PATH /usr/bin');
-    });
-    it('uses export syntax for zshrc even with filePath', () => {
-        const next = upsertShellToken('', 'abc123', '/home/user/.zshrc');
-        expect(next).toContain('export PLAYWRIGHT_MCP_EXTENSION_TOKEN="abc123"');
-        expect(next).not.toContain('set -gx');
-    });
-});
+import { renderBrowserDoctorReport } from './doctor.js';
 describe('doctor report rendering', () => {
     const strip = (s) => s.replace(/\x1b\[[0-9;]*m/g, '');
-    it('renders OK-style report when tokens match', () => {
+    it('renders OK-style report when daemon and extension connected', () => {
         const text = strip(renderBrowserDoctorReport({
-            envToken: 'abc123',
-            envFingerprint: 'fp1',
-            extensionToken: 'abc123',
-            extensionFingerprint: 'fp1',
-            extensionInstalled: true,
-            extensionBrowsers: ['Chrome'],
-            shellFiles: [{ path: '/tmp/.zshrc', exists: true, token: 'abc123', fingerprint: 'fp1' }],
-            configs: [{ path: '/tmp/mcp.json', exists: true, format: 'json', token: 'abc123', fingerprint: 'fp1', writable: true }],
-            recommendedToken: 'abc123',
-            recommendedFingerprint: 'fp1',
-            warnings: [],
+            daemonRunning: true,
+            extensionConnected: true,
             issues: [],
         }));
-        expect(text).toContain('[OK] Extension installed (Chrome)');
-        expect(text).toContain('[OK] Environment token: configured (fp1)');
-        expect(text).toContain('[OK] /tmp/mcp.json');
-        expect(text).toContain('configured (fp1)');
+        expect(text).toContain('[OK] Daemon: running on port 19825');
+        expect(text).toContain('[OK] Extension: connected');
+        expect(text).toContain('Everything looks good!');
+    });
+    it('renders MISSING when daemon not running', () => {
+        const text = strip(renderBrowserDoctorReport({
+            daemonRunning: false,
+            extensionConnected: false,
+            issues: ['Daemon is not running.'],
+        }));
+        expect(text).toContain('[MISSING] Daemon: not running');
+        expect(text).toContain('[MISSING] Extension: not connected');
+        expect(text).toContain('Daemon is not running.');
     });
-    it('renders MISMATCH-style report when fingerprints differ', () => {
+    it('renders extension not connected when daemon is running', () => {
         const text = strip(renderBrowserDoctorReport({
-            envToken: 'abc123',
-            envFingerprint: 'fp1',
-            extensionToken: null,
-            extensionFingerprint: null,
-            extensionInstalled: false,
-            extensionBrowsers: [],
-            shellFiles: [{ path: '/tmp/.zshrc', exists: true, token: 'def456', fingerprint: 'fp2' }],
-            configs: [{ path: '/tmp/mcp.json', exists: true, format: 'json', token: 'abc123', fingerprint: 'fp1', writable: true }],
-            recommendedToken: 'abc123',
-            recommendedFingerprint: 'fp1',
-            warnings: [],
-            issues: ['Detected inconsistent Playwright MCP tokens across env/config files.'],
+            daemonRunning: true,
+            extensionConnected: false,
+            issues: ['Daemon is running but the Chrome extension is not connected.'],
         }));
-        expect(text).toContain('[MISSING] Extension not installed in any browser');
-        expect(text).toContain('[MISMATCH] Environment token: configured (fp1)');
-        expect(text).toContain('[MISMATCH] /tmp/.zshrc');
-        expect(text).toContain('configured (fp2)');
-        expect(text).toContain('[MISMATCH] Recommended token fingerprint: fp1');
+        expect(text).toContain('[OK] Daemon: running on port 19825');
+        expect(text).toContain('[MISSING] Extension: not connected');
     });
     it('renders connectivity OK when live test succeeds', () => {
         const text = strip(renderBrowserDoctorReport({
-            envToken: 'abc123',
-            envFingerprint: 'fp1',
-            extensionToken: 'abc123',
-            extensionFingerprint: 'fp1',
-            extensionInstalled: true,
-            extensionBrowsers: ['Chrome'],
-            shellFiles: [],
-            configs: [],
-            recommendedToken: 'abc123',
-            recommendedFingerprint: 'fp1',
+            daemonRunning: true,
+            extensionConnected: true,
             connectivity: { ok: true, durationMs: 1234 },
-            warnings: [],
             issues: [],
         }));
-        expect(text).toContain('[OK] Browser connectivity: connected in 1.2s');
+        expect(text).toContain('[OK] Connectivity: connected in 1.2s');
     });
-    it('renders connectivity WARN when not tested', () => {
+    it('renders connectivity SKIP when not tested', () => {
         const text = strip(renderBrowserDoctorReport({
-            envToken: 'abc123',
-            envFingerprint: 'fp1',
-            extensionToken: 'abc123',
-            extensionFingerprint: 'fp1',
-            extensionInstalled: true,
-            extensionBrowsers: ['Chrome'],
-            shellFiles: [],
-            configs: [],
-            recommendedToken: 'abc123',
-            recommendedFingerprint: 'fp1',
-            warnings: [],
+            daemonRunning: true,
+            extensionConnected: true,
             issues: [],
         }));
-        expect(text).toContain('[WARN] Browser connectivity: not tested (use --live)');
+        expect(text).toContain('[SKIP] Connectivity: not tested (use --live)');
     });
 });

package/dist/main.js

@@ -122,37 +122,18 @@ program.command('cascade').description('Strategy cascade: find simplest working
     console.log(renderCascadeResult(result));
 });
 program.command('doctor')
-    .description('Diagnose Playwright MCP Bridge, token consistency, and Chrome remote debugging')
-    .option('--fix', 'Apply suggested fixes to shell rc and detected MCP configs', false)
-    .option('-y, --yes', 'Skip confirmation prompts when applying fixes', false)
-    .option('--token <token>', 'Override token to write instead of auto-detecting')
+    .description('Diagnose opencli browser bridge connectivity')
     .option('--live', 'Test browser connectivity (requires Chrome running)', false)
-    .option('--shell-rc <path>', 'Shell startup file to update')
-    .option('--mcp-config <paths>', 'Comma-separated MCP config paths to scan/update')
     .action(async (opts) => {
-    const { runBrowserDoctor, renderBrowserDoctorReport, applyBrowserDoctorFix } = await import('./doctor.js');
-    const configPaths = opts.mcpConfig ? String(opts.mcpConfig).split(',').map((s) => s.trim()).filter(Boolean) : undefined;
-    const report = await runBrowserDoctor({ token: opts.token, live: opts.live, shellRc: opts.shellRc, configPaths, cliVersion: PKG_VERSION });
+    const { runBrowserDoctor, renderBrowserDoctorReport } = await import('./doctor.js');
+    const report = await runBrowserDoctor({ live: opts.live, cliVersion: PKG_VERSION });
     console.log(renderBrowserDoctorReport(report));
-    if (opts.fix) {
-        const written = await applyBrowserDoctorFix(report, { fix: true, yes: opts.yes, token: opts.token, shellRc: opts.shellRc, configPaths });
-        console.log();
-        if (written.length > 0) {
-            console.log(chalk.green('Updated files:'));
-            for (const filePath of written)
-                console.log(`- ${filePath}`);
-        }
-        else {
-            console.log(chalk.yellow('No files were changed.'));
-        }
-    }
 });
 program.command('setup')
-    .description('Interactive setup: configure Playwright MCP token across all detected tools')
-    .option('--token <token>', 'Provide token directly instead of auto-detecting')
-    .action(async (opts) => {
+    .description('Interactive setup: verify browser bridge connectivity')
+    .action(async () => {
     const { runSetup } = await import('./setup.js');
-    await runSetup({ cliVersion: PKG_VERSION, token: opts.token });
+    await runSetup({ cliVersion: PKG_VERSION });
 });
 program.command('completion')
     .description('Output shell completion script')

package/dist/pipeline/executor.test.js

@@ -23,6 +23,7 @@ function createMockPage(overrides = {}) {
         autoScroll: vi.fn(),
         installInterceptor: vi.fn(),
         getInterceptedRequests: vi.fn().mockResolvedValue([]),
+        screenshot: vi.fn().mockResolvedValue(''),
         ...overrides,
     };
 }

package/dist/pipeline/steps/browser.js

@@ -2,7 +2,7 @@
  * Pipeline step: navigate, click, type, wait, press, snapshot.
  * Browser interaction primitives.
  */
-import { render, normalizeEvaluateSource } from '../template.js';
+import { render } from '../template.js';
 export async function stepNavigate(page, params, data, args) {
     const url = render(params, { args, data });
     await page.goto(String(url));
@@ -49,7 +49,7 @@ export async function stepSnapshot(page, params, _data, _args) {
 }
 export async function stepEvaluate(page, params, data, args) {
     const js = String(render(params, { args, data }));
-    let result = await page.evaluate(normalizeEvaluateSource(js));
+    let result = await page.evaluate(js);
     // MCP may return JSON as a string — auto-parse it
     if (typeof result === 'string') {
         const trimmed = result.trim();

package/dist/pipeline/steps/intercept.js

@@ -1,7 +1,7 @@
 /**
  * Pipeline step: intercept — declarative XHR interception.
  */
-import { render } from '../template.js';
+import { render, normalizeEvaluateSource } from '../template.js';
 import { generateInterceptorJs, generateReadInterceptedJs } from '../../interceptor.js';
 export async function stepIntercept(page, params, data, args) {
     const cfg = typeof params === 'object' ? params : {};
@@ -20,7 +20,6 @@ export async function stepIntercept(page, params, data, args) {
     }
     else if (trigger.startsWith('evaluate:')) {
         const js = trigger.slice('evaluate:'.length);
-        const { normalizeEvaluateSource } = await import('../template.js');
         await page.evaluate(normalizeEvaluateSource(render(js, { args, data })));
     }
     else if (trigger.startsWith('click:')) {

package/dist/setup.d.ts

@@ -1,3 +1,9 @@
+/**
+ * setup.ts — Interactive browser setup for opencli
+ *
+ * Simplified for daemon-based architecture. No more token management.
+ * Just verifies daemon + extension connectivity.
+ */
 export declare function runSetup(opts?: {
     cliVersion?: string;
     token?: string;

package/dist/setup.js

@@ -1,180 +1,66 @@
 /**
- * setup.ts — Interactive Playwright MCP token setup
+ * setup.ts — Interactive browser setup for opencli
  *
- * Discovers the extension token, shows an interactive checkbox
- * for selecting which config files to update, and applies changes.
+ * Simplified for daemon-based architecture. No more token management.
+ * Just verifies daemon + extension connectivity.
  */
-import * as fs from 'node:fs';
 import chalk from 'chalk';
-import { createInterface } from 'node:readline/promises';
-import { stdin as input, stdout as output } from 'node:process';
-import { PLAYWRIGHT_TOKEN_ENV, checkExtensionInstalled, checkTokenConnectivity, discoverExtensionToken, fileExists, getDefaultShellRcPath, runBrowserDoctor, shortenPath, toolName, upsertJsonConfigToken, upsertShellToken, upsertTomlConfigToken, writeFileWithMkdir, } from './doctor.js';
-import { getTokenFingerprint } from './browser/index.js';
-import { checkboxPrompt } from './tui.js';
+import { checkDaemonStatus } from './browser/discover.js';
+import { checkConnectivity } from './doctor.js';
+import { PlaywrightMCP } from './browser/index.js';
 export async function runSetup(opts = {}) {
     console.log();
-    console.log(chalk.bold('  opencli setup') + chalk.dim(' — Playwright MCP token configuration'));
+    console.log(chalk.bold('  opencli setup') + chalk.dim(' — browser bridge configuration'));
     console.log();
-    // Step 1: Discover token
-    let token = opts.token ?? null;
-    if (!token) {
-        const extensionToken = discoverExtensionToken();
-        const envToken = process.env[PLAYWRIGHT_TOKEN_ENV] ?? null;
-        if (extensionToken && envToken && extensionToken === envToken) {
-            token = extensionToken;
-            console.log(`  ${chalk.green('✓')} Token auto-discovered from Chrome extension`);
-            console.log(`    Fingerprint: ${chalk.bold(getTokenFingerprint(token) ?? 'unknown')}`);
-        }
-        else if (extensionToken) {
-            token = extensionToken;
-            console.log(`  ${chalk.green('✓')} Token discovered from Chrome extension ` +
-                chalk.dim(`(${getTokenFingerprint(token)})`));
-            if (envToken && envToken !== extensionToken) {
-                console.log(`  ${chalk.yellow('!')} Environment has different token ` +
-                    chalk.dim(`(${getTokenFingerprint(envToken)})`));
-            }
-        }
-        else if (envToken) {
-            token = envToken;
-            console.log(`  ${chalk.green('✓')} Token from environment variable ` +
-                chalk.dim(`(${getTokenFingerprint(token)})`));
-        }
+    // Step 1: Check daemon
+    console.log(chalk.dim('  Checking daemon status...'));
+    const status = await checkDaemonStatus();
+    if (status.running) {
+        console.log(`  ${chalk.green('✓')} Daemon is running on port 19825`);
     }
     else {
-        console.log(`  ${chalk.green('✓')} Using provided token ` +
-            chalk.dim(`(${getTokenFingerprint(token)})`));
-    }
-    if (!token) {
-        // Give precise diagnosis of why token scan failed
-        const extInstall = checkExtensionInstalled();
-        console.log(`  ${chalk.red('✗')} Browser token scan failed\n`);
-        if (!extInstall.installed) {
-            console.log(chalk.dim('  Cause: Playwright MCP Bridge extension is not installed'));
-            console.log(chalk.dim('  Fix:   Install from https://chromewebstore.google.com/detail/'));
-            console.log(chalk.dim('         playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm'));
-        }
-        else {
-            console.log(chalk.dim(`  Cause: Extension is installed (${extInstall.browsers.join(', ')}) but token not found in LevelDB`));
-            console.log(chalk.dim('  Fix:   1) Open the extension popup and verify the token is generated'));
-            console.log(chalk.dim('         2) Close Chrome completely, then re-run setup'));
-        }
-        console.log();
-        console.log(`  You can enter the token manually, or fix the above and re-run ${chalk.bold('opencli setup')}.`);
-        console.log();
-        const rl = createInterface({ input, output });
-        const answer = await rl.question('  Token (press Enter to abort): ');
-        rl.close();
-        token = answer.trim();
-        if (!token) {
-            console.log(chalk.red('\n  No token provided. Aborting.\n'));
-            return;
-        }
-    }
-    const fingerprint = getTokenFingerprint(token) ?? 'unknown';
-    console.log();
-    // Step 2: Scan all config locations
-    const report = await runBrowserDoctor({ token, cliVersion: opts.cliVersion });
-    // Step 3: Build checkbox items
-    const items = [];
-    // Shell file
-    const shellPath = report.shellFiles[0]?.path ?? getDefaultShellRcPath();
-    const shellStatus = report.shellFiles[0];
-    const shellFp = shellStatus?.fingerprint;
-    const shellOk = shellFp === fingerprint;
-    const shellTool = toolName(shellPath) || 'Shell';
-    items.push({
-        label: padRight(shortenPath(shellPath), 50) + chalk.dim(` [${shellTool}]`),
-        value: `shell:${shellPath}`,
-        checked: !shellOk,
-        status: shellOk ? `configured (${shellFp})` : shellFp ? `mismatch (${shellFp})` : 'missing',
-        statusColor: shellOk ? 'green' : shellFp ? 'yellow' : 'red',
-    });
-    // Config files
-    for (const config of report.configs) {
-        const fp = config.fingerprint;
-        const ok = fp === fingerprint;
-        const tool = toolName(config.path);
-        items.push({
-            label: padRight(shortenPath(config.path), 50) + chalk.dim(tool ? ` [${tool}]` : ''),
-            value: `config:${config.path}`,
-            checked: false, // let user explicitly select which tools to configure
-            status: ok ? `configured (${fp})` : !config.exists ? 'will create' : fp ? `mismatch (${fp})` : 'missing',
-            statusColor: ok ? 'green' : 'yellow',
-        });
-    }
-    // Step 4: Show interactive checkbox
-    console.clear();
-    const selected = await checkboxPrompt(items, {
-        title: `  ${chalk.bold('opencli setup')} — token ${chalk.cyan(fingerprint)}`,
-    });
-    if (selected.length === 0) {
-        console.log(chalk.dim('  No changes made.\n'));
-        return;
-    }
-    // Step 5: Apply changes
-    const written = [];
-    let wroteShell = false;
-    for (const sel of selected) {
-        if (sel.startsWith('shell:')) {
-            const p = sel.slice('shell:'.length);
-            const before = fileExists(p) ? fs.readFileSync(p, 'utf-8') : '';
-            writeFileWithMkdir(p, upsertShellToken(before, token, p));
-            written.push(p);
-            wroteShell = true;
+        console.log(`  ${chalk.yellow('!')} Daemon is not running`);
+        console.log(chalk.dim('    The daemon starts automatically when you run a browser command.'));
+        console.log(chalk.dim('    Starting daemon now...'));
+        // Try to spawn daemon
+        const mcp = new PlaywrightMCP();
+        try {
+            await mcp.connect({ timeout: 5 });
+            await mcp.close();
+            console.log(`  ${chalk.green('✓')} Daemon started successfully`);
         }
-        else if (sel.startsWith('config:')) {
-            const p = sel.slice('config:'.length);
-            const config = report.configs.find(c => c.path === p);
-            if (config && config.parseError)
-                continue;
-            const before = fileExists(p) ? fs.readFileSync(p, 'utf-8') : '';
-            const format = config?.format ?? (p.endsWith('.toml') ? 'toml' : 'json');
-            const next = format === 'toml' ? upsertTomlConfigToken(before, token) : upsertJsonConfigToken(before, token, p);
-            writeFileWithMkdir(p, next);
-            written.push(p);
+        catch {
+            console.log(`  ${chalk.yellow('!')} Could not start daemon automatically`);
         }
     }
-    process.env[PLAYWRIGHT_TOKEN_ENV] = token;
-    // Step 6: Summary
-    if (written.length > 0) {
-        console.log(chalk.green.bold(`  ✓ Updated ${written.length} file(s):`));
-        for (const p of written) {
-            const tool = toolName(p);
-            console.log(`    ${chalk.dim('•')} ${shortenPath(p)}${tool ? chalk.dim(` [${tool}]`) : ''}`);
-        }
-        if (wroteShell) {
-            console.log();
-            console.log(chalk.cyan(`  💡 Run ${chalk.bold(`source ${shortenPath(shellPath)}`)} to apply token to current shell.`));
-        }
+    // Step 2: Check extension
+    const statusAfter = await checkDaemonStatus();
+    if (statusAfter.extensionConnected) {
+        console.log(`  ${chalk.green('✓')} Chrome extension connected`);
     }
     else {
-        console.log(chalk.yellow('  No files were changed.'));
+        console.log(`  ${chalk.red('✗')} Chrome extension not connected`);
+        console.log();
+        console.log(chalk.dim('  To install the opencli Browser Bridge extension:'));
+        console.log(chalk.dim('    1. Download from GitHub Releases'));
+        console.log(chalk.dim('    2. Open chrome://extensions/ → Enable Developer Mode'));
+        console.log(chalk.dim('    3. Click "Load unpacked" → select the extension folder'));
+        console.log(chalk.dim('    4. Make sure Chrome is running'));
+        console.log();
+        return;
     }
+    // Step 3: Test connectivity
     console.log();
-    // Step 7: Auto-verify browser connectivity
-    console.log(chalk.dim('  Verifying browser connectivity...'));
-    try {
-        const result = await checkTokenConnectivity({ timeout: 5 });
-        if (result.ok) {
-            console.log(`  ${chalk.green('✓')} Browser connected in ${(result.durationMs / 1000).toFixed(1)}s`);
-        }
-        else {
-            console.log(`  ${chalk.green('✓')} Token saved successfully.`);
-            console.log(`  ${chalk.yellow('!')} Browser connectivity test failed: ${result.error ?? 'unknown'}`);
-            console.log(chalk.dim('    Token configuration is complete. To use opencli, make sure Chrome'));
-            console.log(chalk.dim('    is running with the Playwright MCP Bridge extension enabled.'));
-            console.log(chalk.dim(`    Run ${chalk.bold('opencli doctor --live')} to re-test connectivity.`));
-        }
+    console.log(chalk.dim('  Testing browser connectivity...'));
+    const conn = await checkConnectivity({ timeout: 5 });
+    if (conn.ok) {
+        console.log(`  ${chalk.green('✓')} Browser connected in ${(conn.durationMs / 1000).toFixed(1)}s`);
+        console.log();
+        console.log(chalk.green.bold('  ✓ Setup complete! You can now use opencli browser commands.'));
     }
-    catch {
-        console.log(`  ${chalk.green('✓')} Token saved successfully.`);
-        console.log(`  ${chalk.yellow('!')} Browser connectivity test skipped (Chrome may not be running).`);
-        console.log(chalk.dim('    Token configuration is complete. Start Chrome to begin using opencli.'));
-        console.log(chalk.dim(`    Run ${chalk.bold('opencli doctor --live')} to re-test connectivity.`));
+    else {
+        console.log(`  ${chalk.yellow('!')} Connectivity test failed: ${conn.error ?? 'unknown'}`);
+        console.log(chalk.dim(`    Run ${chalk.bold('opencli doctor --live')} to diagnose.`));
     }
     console.log();
 }
-function padRight(s, n) {
-    const visible = s.replace(/\x1b\[[0-9;]*m/g, '');
-    return visible.length >= n ? s : s + ' '.repeat(n - visible.length);
-}

package/dist/types.d.ts

@@ -34,4 +34,10 @@ export interface IPage {
     }): Promise<void>;
     installInterceptor(pattern: string): Promise<void>;
     getInterceptedRequests(): Promise<any[]>;
+    screenshot(options?: {
+        format?: 'png' | 'jpeg';
+        quality?: number;
+        fullPage?: boolean;
+        path?: string;
+    }): Promise<string>;
 }

package/extension/manifest.json

@@ -0,0 +1,31 @@
+{
+  "manifest_version": 3,
+  "name": "opencli Browser Bridge",
+  "version": "0.1.0",
+  "description": "Bridge between opencli CLI and your browser — execute commands, read cookies, manage tabs.",
+  "permissions": [
+    "debugger",
+    "tabs",
+    "cookies",
+    "activeTab",
+    "alarms"
+  ],
+  "background": {
+    "service_worker": "dist/background.js",
+    "type": "module"
+  },
+  "icons": {
+    "16": "icons/icon-16.png",
+    "32": "icons/icon-32.png",
+    "48": "icons/icon-48.png",
+    "128": "icons/icon-128.png"
+  },
+  "action": {
+    "default_title": "opencli Browser Bridge",
+    "default_icon": {
+      "16": "icons/icon-16.png",
+      "32": "icons/icon-32.png"
+    }
+  },
+  "homepage_url": "https://github.com/jackwener/opencli"
+}

package/extension/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "opencli-extension",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/chrome": "^0.0.287",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0"
+  }
+}