@cli4ai/chrome 1.0.0

package/README.md

@@ -0,0 +1,19 @@
+# Chrome
+
+Browser automation with your profile.
+
+## Start
+
+```bash
+./start.sh           # Launch Chrome (quit Chrome first)
+./run.js connect     # Connect puppeteer
+```
+
+## Commands
+
+```bash
+./run.js navigate <url> [--new-tab]
+./run.js eval "<js>"
+./run.js screenshot [file] [--full-page]
+./run.js cookies [domain]
+```

package/c4ai.json

@@ -0,0 +1,22 @@
+{
+  "name": "chrome",
+  "version": "1.0.0",
+  "description": "Chrome browser automation (foundation for browser tools)",
+  "author": "cliforai",
+  "license": "MIT",
+  "entry": "run.ts",
+  "runtime": "bun",
+  "keywords": ["chrome", "browser", "puppeteer", "automation"],
+  "commands": {
+    "connect": { "description": "Connect to Chrome", "args": [{ "name": "port", "description": "Default: 9222", "required": false }] },
+    "navigate": { "description": "Open URL", "args": [{ "name": "url", "required": true }] },
+    "eval": { "description": "Run JavaScript", "args": [{ "name": "script", "required": true }] },
+    "screenshot": { "description": "Capture viewport", "args": [{ "name": "output", "required": false }] },
+    "cookies": { "description": "Get cookies", "args": [{ "name": "domain", "required": false }] }
+  },
+  "dependencies": {
+    "puppeteer": "^24.0.0",
+    "commander": "^14.0.0"
+  },
+  "mcp": { "enabled": true, "transport": "stdio" }
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@cli4ai/chrome",
+  "version": "1.0.0",
+  "description": "Chrome browser automation (foundation for browser tools)",
+  "author": "cliforai",
+  "license": "MIT",
+  "main": "run.ts",
+  "bin": {
+    "chrome": "./run.ts"
+  },
+  "type": "module",
+  "keywords": [
+    "c4ai",
+    "cli",
+    "ai-tools",
+    "chrome",
+    "browser",
+    "puppeteer",
+    "automation"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cli4ai/packages",
+    "directory": "packages/chrome"
+  },
+  "homepage": "https://github.com/cli4ai/packages/tree/main/packages/chrome",
+  "bugs": {
+    "url": "https://github.com/cli4ai/packages/issues"
+  },
+  "files": [
+    "run.ts",
+    "c4ai.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "bun test"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/run.ts

@@ -0,0 +1,86 @@
+#!/usr/bin/env bun
+import puppeteer from 'puppeteer';
+import { readFileSync, writeFileSync } from 'fs';
+import { join, resolve } from 'path';
+import { cli, output, outputError, withErrorHandling } from '../lib/cli.ts';
+
+const WS_FILE = join(import.meta.dir, '.ws-endpoint');
+
+async function getPage(newTab = false) {
+  let ws: string;
+  try {
+    ws = readFileSync(WS_FILE, 'utf-8');
+  } catch {
+    outputError('NOT_FOUND', 'Not connected to Chrome', {
+      hint: 'Run: chrome connect'
+    });
+  }
+
+  const browser = await puppeteer.connect({ browserWSEndpoint: ws });
+  const pages = await browser.pages();
+  const page = newTab ? await browser.newPage() : (pages[pages.length - 1] || await browser.newPage());
+  return { page, browser };
+}
+
+const program = cli('chrome', '1.0.0', 'Chrome browser automation');
+
+program
+  .command('connect [port]')
+  .description('Connect to Chrome (default: 9222)')
+  .action(withErrorHandling(async (port = '9222') => {
+    const browser = await puppeteer.connect({ browserURL: `http://127.0.0.1:${port}` });
+    writeFileSync(WS_FILE, browser.wsEndpoint());
+    console.log(`Connected on port ${port}`);
+    browser.disconnect();
+  }));
+
+program
+  .command('navigate <url>')
+  .description('Open URL')
+  .option('--new-tab', 'Open in new tab')
+  .action(withErrorHandling(async (url: string, options: { newTab?: boolean }) => {
+    const { page, browser } = await getPage(options.newTab);
+    await page.goto(url, { waitUntil: 'networkidle2' });
+    console.log(await page.title());
+    if (options.newTab) await page.close();
+    browser.disconnect();
+  }));
+
+program
+  .command('eval <script>')
+  .description('Run JavaScript')
+  .action(withErrorHandling(async (script: string) => {
+    const { page, browser } = await getPage();
+    const result = await page.evaluate((code: string) => eval(code), script);
+    if (result !== undefined) output(result);
+    browser.disconnect();
+  }));
+
+program
+  .command('screenshot [output]')
+  .description('Capture viewport')
+  .option('--full-page', 'Capture full page')
+  .action(withErrorHandling(async (outputFile = 'screenshot.png', options: { fullPage?: boolean }) => {
+    const { page, browser } = await getPage();
+    const outputPath = resolve(outputFile);
+    await page.screenshot({ path: outputPath, fullPage: options.fullPage });
+    console.log(`Saved: ${outputPath}`);
+    browser.disconnect();
+  }));
+
+program
+  .command('cookies [domain]')
+  .description('Get cookies')
+  .action(withErrorHandling(async (domain?: string) => {
+    const { page, browser } = await getPage();
+    const client = await page.createCDPSession();
+    const { cookies } = await client.send('Network.getAllCookies');
+    const filtered = domain && domain !== '--all'
+      ? cookies.filter((c: { domain: string }) => c.domain.includes(domain))
+      : cookies;
+    output(filtered);
+    console.error(`\n${filtered.length} cookies`);
+    browser.disconnect();
+  }));
+
+program.parse();