@pxlarified/browser 1.9.6 → 1.9.8

package/README.md

@@ -8,7 +8,7 @@
 
 <p align="center">
   <img alt="Node.js" src="https://img.shields.io/badge/Node.js-%3E%3D20-339933?style=flat-square&logo=node.js&logoColor=white">
-  <img alt="Version" src="https://img.shields.io/badge/version-1.9.6-blue?style=flat-square">
+  <img alt="Version" src="https://img.shields.io/badge/version-1.9.8-blue?style=flat-square">
   <img alt="Browser" src="https://img.shields.io/badge/browser-Zen-7F52FF?style=flat-square">
   <img alt="Firefox Extension" src="https://img.shields.io/badge/Firefox-WebExtension-FF7139?style=flat-square&logo=firefoxbrowser&logoColor=white">
 </p>
@@ -25,7 +25,7 @@ The npm package is published as `@pxlarified/browser` and is intended to be used
 npx @pxlarified/browser <command>
 ```
 
-The local agent skill lives in `skills/OpenBrowser/` and is not published as a separate npm skill package.
+The local agent skill lives in `skills/browser/` and can be installed from the npm package.
 
 ## License
 
@@ -71,6 +71,18 @@ The installer does the following.
 
 Restart Zen if the extension update does not load immediately.
 
+### Agent skill installation
+
+Install the bundled `browser` skill into a Pi agent directory or an existing `skills` directory.
+
+```sh
+npx @pxlarified/browser install skills --to '.pi/agent/'
+# alias:
+npx @pxlarified/browser install skill --to '.pi/agent/'
+```
+
+If `--to` points at an agent directory such as `.pi/agent`, OpenBrowser writes `.pi/agent/skills/browser/SKILL.md`. If `--to` already points at `.pi/agent/skills`, it writes `.pi/agent/skills/browser/SKILL.md` without appending another `skills` segment.
+
 ## Usage
 
 `--browser zen` is optional while Zen is the only supported browser.
@@ -265,7 +277,7 @@ The package is configured with.
 }
 ```
 
-The npm package includes the CLI, source, extension source, and bundled extension artifacts. It does not publish `.env`, `node_modules`, build scratch files, or the local `skills/` directory.
+The npm package includes the CLI, source, extension source, bundled extension artifacts, and the installable `skills/browser/` skill. It does not publish `.env`, `node_modules`, or build scratch files.
 
 ## Development
 

package/extensions/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 2,
   "name": "OpenBrowser",
-  "version": "1.9.6",
+  "version": "1.9.8",
   "description": "Local user-scoped browser control bridge for the OpenBrowser CLI.",
   "icons": {
     "48": "assets/logo.svg",
@@ -16,7 +16,9 @@
     "<all_urls>"
   ],
   "background": {
-    "scripts": ["background.js"],
+    "scripts": [
+      "background.js"
+    ],
     "persistent": true
   },
   "browser_specific_settings": {
@@ -24,7 +26,9 @@
       "id": "openbrowser@mizius.com",
       "strict_min_version": "109.0",
       "data_collection_permissions": {
-        "required": ["none"]
+        "required": [
+          "none"
+        ]
       }
     }
   }

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@pxlarified/browser",
-  "version": "1.9.6",
+  "version": "1.9.8",
   "description": "Minimal local browser-control CLI for OpenBrowser.",
   "type": "module",
   "bin": {
     "OpenBrowser": "./bin/OpenBrowser.js"
   },
   "scripts": {
+    "sync:version": "node scripts/sync-version.js",
     "build": "node scripts/build.js firefox",
     "build:firefox": "node scripts/build.js firefox",
     "release:firefox": "node scripts/sign-firefox.js",
@@ -22,6 +23,7 @@
     "assets/",
     "dist/extensions/",
     "scripts/",
+    "skills/browser/",
     "README.md",
     "package.json"
   ],

package/scripts/sync-version.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const packageJsonPath = path.join(root, "package.json");
+const manifestPath = path.join(root, "extensions", "manifest.json");
+const readmePath = path.join(root, "README.md");
+
+const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+const version = packageJson.version;
+
+if (!version) throw new Error("package.json is missing a version.");
+
+let changed = false;
+
+const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+if (manifest.version !== version) {
+  manifest.version = version;
+  fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+  console.log(`Updated extensions/manifest.json version to ${version}`);
+  changed = true;
+}
+
+const readme = fs.readFileSync(readmePath, "utf8");
+const escapedVersion = version.replace(/-/g, "--").replace(/_/g, "__");
+const updatedReadme = readme.replace(
+  /https:\/\/img\.shields\.io\/badge\/version-[^-\s"]+-blue\?style=flat-square/g,
+  `https://img.shields.io/badge/version-${escapedVersion}-blue?style=flat-square`,
+);
+
+if (updatedReadme !== readme) {
+  fs.writeFileSync(readmePath, updatedReadme);
+  console.log(`Updated README.md version badge to ${version}`);
+  changed = true;
+}
+
+if (!changed) console.log(`Version metadata already matches ${version}`);

package/skills/browser/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: browser
+description: Use a web browser.
+---
+
+## OpenBrowser
+
+Run commands through the npm package.
+```bash
+npx @pxlarified/browser <command>
+```
+
+Close the session after you are done (unless it contains important information or you want to keep it warm for another session).
+
+### Usage 
+`--browser zen` is optional.
+
+```bash
+# Installation
+npx @pxlarified/browser install zen
+
+# Session management
+npx @pxlarified/browser open <url> --browser zen
+npx @pxlarified/browser close --browser zen
+npx @pxlarified/browser status --browser zen
+
+# Navigation
+npx @pxlarified/browser navigate <url> --browser zen
+npx @pxlarified/browser reload --browser zen
+npx @pxlarified/browser back --browser zen
+npx @pxlarified/browser forward --browser zen
+
+# Page state
+npx @pxlarified/browser state --browser zen
+
+# Screenshots
+npx @pxlarified/browser screenshot --browser zen
+npx @pxlarified/browser screenshot --base64 --browser zen
+
+# Interaction
+npx @pxlarified/browser click <ref> --browser zen
+npx @pxlarified/browser keys <text> --browser zen
+npx @pxlarified/browser press <key> --browser zen
+npx @pxlarified/browser select <ref> <option> --browser zen
+
+# Content inspection
+npx @pxlarified/browser get --html --browser zen
+npx @pxlarified/browser get --html --ref <ref> --browser zen
+
+# Scrolling
+npx @pxlarified/browser scroll up [pixels] --browser zen
+npx @pxlarified/browser scroll down [pixels] --browser zen
+npx @pxlarified/browser scroll --to <ref> --browser zen
+```

package/src/cli.js

@@ -1,6 +1,7 @@
 import crypto from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
+import { fileURLToPath } from "node:url";
 import { resolveBrowser, supportedBrowsers } from "./browsers/registry.js";
 import { BridgeUnavailableError, sendBridgeCommandWithRetry } from "./bridge/client.js";
 import { screenshotsDir } from "./util/paths.js";
@@ -16,7 +17,15 @@ export async function runCli(argv) {
   const adapter = resolveBrowser(parsed.browser);
 
   if (command === "install") {
-    const browserName = positionals[0] || parsed.browser;
+    const target = positionals[0];
+    if (target === "skill" || target === "skills") {
+      const result = installBrowserSkill(parsed.flags.get("to"));
+      console.error(result.note);
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+
+    const browserName = target || parsed.browser;
     if (!browserName) throw new Error(`Usage: OpenBrowser install <browser>`);
     const installAdapter = resolveBrowser(browserName);
     const result = await installAdapter.install();
@@ -126,6 +135,25 @@ function requireArgs(name, args, count, request) {
   return request;
 }
 
+function installBrowserSkill(to) {
+  if (!to) throw new Error("Usage: OpenBrowser install skills --to <agent-dir-or-skills-dir>");
+
+  const requested = path.resolve(to);
+  const skillsDir = path.basename(requested) === "skills" ? requested : path.join(requested, "skills");
+  const destination = path.join(skillsDir, "browser");
+  const source = fileURLToPath(new URL("../skills/browser/SKILL.md", import.meta.url));
+
+  fs.mkdirSync(destination, { recursive: true });
+  fs.copyFileSync(source, path.join(destination, "SKILL.md"));
+
+  return {
+    skill: "browser",
+    destination,
+    files: [path.join(destination, "SKILL.md")],
+    note: `Installed browser skill to ${destination}.`,
+  };
+}
+
 async function printResult(request, result) {
   if (request.command === "screenshot") {
     const base64 = normalizeBase64(result.dataUrl || result.base64 || "");
@@ -151,5 +179,5 @@ function normalizeBase64(value) {
 }
 
 function printHelp() {
-  console.log(`OpenBrowser\n\nUsage:\n  OpenBrowser install <browser>\n  OpenBrowser open <url> [--browser zen]\n  OpenBrowser close [--browser zen]\n  OpenBrowser status [--browser zen]\n  OpenBrowser navigate <url> [--browser zen]\n  OpenBrowser reload|back|forward [--browser zen]\n  OpenBrowser state [--browser zen]\n  OpenBrowser screenshot [--base64] [--browser zen]\n  OpenBrowser click <ref> [--browser zen]\n  OpenBrowser keys <text> [--browser zen]\n  OpenBrowser press <key> [--browser zen]\n  OpenBrowser select <ref> <option> [--browser zen]\n  OpenBrowser get --html [--ref <ref>] [--browser zen]\n  OpenBrowser scroll up|down [pixels] [--browser zen]\n  OpenBrowser scroll --to <ref> [--browser zen]\n\nSupported browsers: ${supportedBrowsers().join(", ")}`);
+  console.log(`OpenBrowser\n\nUsage:\n  OpenBrowser install <browser>\n  OpenBrowser install skills --to <agent-dir-or-skills-dir>\n  OpenBrowser open <url> [--browser zen]\n  OpenBrowser close [--browser zen]\n  OpenBrowser status [--browser zen]\n  OpenBrowser navigate <url> [--browser zen]\n  OpenBrowser reload|back|forward [--browser zen]\n  OpenBrowser state [--browser zen]\n  OpenBrowser screenshot [--base64] [--browser zen]\n  OpenBrowser click <ref> [--browser zen]\n  OpenBrowser keys <text> [--browser zen]\n  OpenBrowser press <key> [--browser zen]\n  OpenBrowser select <ref> <option> [--browser zen]\n  OpenBrowser get --html [--ref <ref>] [--browser zen]\n  OpenBrowser scroll up|down [pixels] [--browser zen]\n  OpenBrowser scroll --to <ref> [--browser zen]\n\nSupported browsers: ${supportedBrowsers().join(", ")}`);
 }