@pxlarified/browser 1.9.5 → 1.9.8

package/LICENSE

@@ -0,0 +1,13 @@
+Fork-for-Pull-Request-Only License
+
+Copyright (c) 2026 OpenBrowser contributors.
+
+Permission is granted only to fork this repository and make changes solely for the purpose of preparing and submitting a pull request back to the upstream OpenBrowser repository.
+
+No other rights are granted. Without prior written permission from the copyright holder, you may not use, copy, publish, distribute, sublicense, sell, host, run as a service, package, release, modify outside the pull-request purpose above, or create derivative works for any other purpose.
+
+If your pull request or any portion of it is accepted into the upstream repository, the accepted contribution is licensed to the upstream project under this same license unless a separate written agreement says otherwise.
+
+All copies or forks made under this license must retain this license notice.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OF OR OTHER DEALINGS IN THE SOFTWARE.

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.5-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,11 @@ 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
+
+This project uses a custom fork-for-pull-request-only license. It grants permission only to fork the repository and make changes for submitting a pull request upstream; no other use, distribution, or derivative-work rights are granted. See [LICENSE](LICENSE).
 
 ## Features
 
@@ -67,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.
@@ -261,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.5",
+  "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.5",
+  "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"
   ],
@@ -35,5 +37,5 @@
     "web-ext": "^8.3.0",
     "yazl": "^3.3.1"
   },
-  "license": "UNLICENSED"
+  "license": "SEE LICENSE IN LICENSE"
 }

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(", ")}`);
 }