feat(browser-tools): add Chrome DevTools helper CLI

based on https://github.com/steipete/agent-scripts/blob/2002ed5c2387d2d492a77b8dece56e218f817696/scripts/browser-tools.ts

Author: patricktree

AGENTS.md

@@ -23,6 +23,7 @@
 - TypeScript-first; follow shared configs from `@patricktree/config-eslint` and `@patricktree/config-typescript`.
 - Format with Prettier
 - Prefer `camelCase` for functions/variables, `PascalCase` for types/classes, and lower-case descriptive filenames under `src/`.
+- Only disable ESLint rules when there is truly no other viable option; prefer code or config fixes instead.
 - Respect each package's module target (CommonJS vs ESM) and keep exports aligned with existing `package.json` fields.
 
 ## Testing Guidelines

packages/browser-tools/.eslintrc.cjs

@@ -0,0 +1,15 @@
+const baseEslintConfig = require('@patricktree/config-eslint/eslint-ecma.cjs');
+
+module.exports = {
+  ...baseEslintConfig,
+  parserOptions: {
+    ...baseEslintConfig.parserOptions,
+    tsconfigRootDir: __dirname,
+  },
+  ignorePatterns: [...(baseEslintConfig.ignorePatterns || []), '**/bin/browser-tools-cli.js'],
+  rules: {
+    ...baseEslintConfig.rules,
+    /* allow for this package to use console logs - is a CLI application */
+    'no-console': 'off',
+  },
+};

packages/browser-tools/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: browser-tools
+description: A standalone Chrome helper. It launches/inspects DevTools-enabled Chrome profiles, pastes prompts, captures screenshots, and kills stray helper processes.
+---
+
+# browser-tools
+
+## Description
+
+A standalone Chrome helper inspired by Mario Zechner’s [“What if you don’t need MCP?”](https://mariozechner.at/posts/2025-11-02-what-if-you-dont-need-mcp/) article. It launches/inspects DevTools-enabled Chrome profiles, pastes prompts, captures screenshots, and kills stray helper processes without needing the full Oracle CLI.
+
+## Usage
+
+`./bin/browser-tools-cli.js`
+
+Common commands include `start --profile`, `nav <url>`, `eval '<js>'`, `screenshot`, `search --content "<query>"`, `content <url>`, `inspect`, and `kill --all --force`

packages/browser-tools/bin/browser-tools-cli.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+
+try {
+  await import('../dist/cli.js');
+} catch (err) {
+  if (
+    err.code === 'ERR_MODULE_NOT_FOUND' &&
+    err.message.includes('Cannot find package') &&
+    err.message.includes('dist/cli.js')
+  ) {
+    throw new Error(
+      'Could not find JS code to execute! Build this workspace project to fix this.',
+      { cause: err },
+    );
+  }
+  throw err;
+}

packages/browser-tools/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@patricktree/browser-tools",
+  "private": true,
+  "type": "module",
+  "exports": {
+    ".": null,
+    "./*": null
+  },
+  "bin": {
+    "browser-tools": "./bin/browser-tools-cli.js"
+  },
+  "files": [
+    "dist/**",
+    "!dist/**/*.d.ts.map"
+  ],
+  "scripts": {
+    "build": "pnpm run internal:compile",
+    "dev": "pnpm run build --watch --preserveWatchOutput",
+    "internal:compile": "tsc -p ./tsconfig.project.json",
+    "lint": "pnpm run lint:file .",
+    "lint:file": "eslint --max-warnings 0",
+    "lint:fix": "pnpm run lint --fix",
+    "nuke": "pnpm run nuke:artifacts && del-cli node_modules",
+    "nuke:artifacts": "del-cli dist \"*.tsbuildinfo\""
+  },
+  "dependencies": {
+    "commander": "^14.0.0",
+    "puppeteer-core": "^23.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20"
+  }
+}