@vibemastery/zurf 0.1.0 → 0.2.3

package/oclif.manifest.json

@@ -1,5 +1,61 @@
 {
   "commands": {
+    "browse": {
+      "aliases": [],
+      "args": {
+        "url": {
+          "description": "URL to browse",
+          "name": "url",
+          "required": true
+        }
+      },
+      "description": "Browse a URL in a cloud browser and return the rendered content as markdown (default) or raw HTML.\nUses a real Chromium browser via Browserbase, so JavaScript-heavy pages are fully rendered.\nRequires authentication and a Project ID. Run `zurf init --global` before first use.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> https://example.com",
+        "<%= config.bin %> <%= command.id %> https://example.com --html",
+        "<%= config.bin %> <%= command.id %> https://example.com --json",
+        "<%= config.bin %> <%= command.id %> https://example.com -o page.md"
+      ],
+      "flags": {
+        "html": {
+          "description": "Output raw HTML instead of markdown",
+          "env": "ZURF_HTML",
+          "name": "html",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Print machine-readable JSON to stdout",
+          "env": "ZURF_JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "output": {
+          "char": "o",
+          "description": "Write rendered content to this file (full content); otherwise human mode prints a truncated preview to stdout",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "browse",
+      "pluginAlias": "@vibemastery/zurf",
+      "pluginName": "@vibemastery/zurf",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Browse a URL in a cloud browser and return rendered content as markdown",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "browse",
+        "index.js"
+      ]
+    },
     "config:which": {
       "aliases": [],
       "args": {},
@@ -9,6 +65,13 @@
         "<%= config.bin %> config which --json"
       ],
       "flags": {
+        "html": {
+          "description": "Output raw HTML instead of markdown",
+          "env": "ZURF_HTML",
+          "name": "html",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "json": {
           "description": "Print machine-readable JSON to stdout",
           "env": "ZURF_JSON",
@@ -34,6 +97,81 @@
         "which.js"
       ]
     },
+    "init": {
+      "aliases": [],
+      "args": {},
+      "description": "Save your Browserbase API key and optional Project ID to global or project config.\nGlobal path follows oclif config (same as `zurf config which`).",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --global",
+        "<%= config.bin %> <%= command.id %> --local",
+        "<%= config.bin %> <%= command.id %> --global --api-key KEY --project-id PROJ_ID",
+        "printenv BROWSERBASE_API_KEY | <%= config.bin %> <%= command.id %> --global"
+      ],
+      "flags": {
+        "html": {
+          "description": "Output raw HTML instead of markdown",
+          "env": "ZURF_HTML",
+          "name": "html",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Print machine-readable JSON to stdout",
+          "env": "ZURF_JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "api-key": {
+          "description": "API key for non-interactive use. Prefer piping stdin or using a TTY prompt — values on the command line are visible in shell history and process listings.",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "gitignore": {
+          "description": "Append .zurf/ to ./.gitignore if that entry is missing",
+          "name": "gitignore",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "global": {
+          "description": "Store API key in user config (oclif config dir for this CLI)",
+          "name": "global",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "local": {
+          "description": "Store API key in ./.zurf/config.json for this directory",
+          "name": "local",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "project-id": {
+          "description": "Browserbase Project ID (optional; needed for browse, screenshot, pdf commands)",
+          "name": "project-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "init",
+      "pluginAlias": "@vibemastery/zurf",
+      "pluginName": "@vibemastery/zurf",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Configure Browserbase API key and Project ID storage",
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "init",
+        "index.js"
+      ]
+    },
     "fetch": {
       "aliases": [],
       "args": {
@@ -43,13 +181,21 @@
           "required": true
         }
       },
-      "description": "Fetch a URL via Browserbase (no browser session; static HTML, 1 MB max).\nRequires authentication. Run `zurf init --global` or use a project key before first use.",
+      "description": "Fetch a URL via Browserbase and return content as markdown (default) or raw HTML (no browser session; static HTML, 1 MB max).\nRequires authentication. Run `zurf init --global` or use a project key before first use.",
       "examples": [
         "<%= config.bin %> <%= command.id %> https://example.com",
+        "<%= config.bin %> <%= command.id %> https://example.com --html",
         "<%= config.bin %> <%= command.id %> https://example.com --json",
-        "<%= config.bin %> <%= command.id %> https://example.com -o page.html --proxies"
+        "<%= config.bin %> <%= command.id %> https://example.com -o page.md --proxies"
       ],
       "flags": {
+        "html": {
+          "description": "Output raw HTML instead of markdown",
+          "env": "ZURF_HTML",
+          "name": "html",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "json": {
           "description": "Print machine-readable JSON to stdout",
           "env": "ZURF_JSON",
@@ -91,7 +237,7 @@
       "pluginName": "@vibemastery/zurf",
       "pluginType": "core",
       "strict": true,
-      "summary": "Fetch a URL via Browserbase",
+      "summary": "Fetch a URL via Browserbase and return content as markdown",
       "isESM": true,
       "relativePath": [
         "dist",
@@ -115,6 +261,13 @@
         "<%= config.bin %> <%= command.id %> \"laravel inertia\" --num-results 5 --json"
       ],
       "flags": {
+        "html": {
+          "description": "Output raw HTML instead of markdown",
+          "env": "ZURF_HTML",
+          "name": "html",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "json": {
           "description": "Print machine-readable JSON to stdout",
           "env": "ZURF_JSON",
@@ -147,67 +300,7 @@
         "search",
         "index.js"
       ]
-    },
-    "init": {
-      "aliases": [],
-      "args": {},
-      "description": "Save your Browserbase API key to global or project config.\nGlobal path follows oclif config (same as `zurf config which`).",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --global",
-        "<%= config.bin %> <%= command.id %> --local",
-        "printenv BROWSERBASE_API_KEY | <%= config.bin %> <%= command.id %> --global"
-      ],
-      "flags": {
-        "json": {
-          "description": "Print machine-readable JSON to stdout",
-          "env": "ZURF_JSON",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "api-key": {
-          "description": "API key for non-interactive use. Prefer piping stdin or using a TTY prompt — values on the command line are visible in shell history and process listings.",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "gitignore": {
-          "description": "Append .zurf/ to ./.gitignore if that entry is missing",
-          "name": "gitignore",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "global": {
-          "description": "Store API key in user config (oclif config dir for this CLI)",
-          "name": "global",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "local": {
-          "description": "Store API key in ./.zurf/config.json for this directory",
-          "name": "local",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "init",
-      "pluginAlias": "@vibemastery/zurf",
-      "pluginName": "@vibemastery/zurf",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Configure Browserbase API key storage",
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "init",
-        "index.js"
-      ]
     }
   },
-  "version": "0.1.0"
+  "version": "0.2.3"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vibemastery/zurf",
   "description": "A lightweight CLI for searching and fetching web pages, powered by Browserbase.",
-  "version": "0.1.0",
+  "version": "0.2.3",
   "author": "Luis Güette",
   "bin": {
     "zurf": "./bin/run.js"
@@ -14,7 +14,9 @@
     "@oclif/plugin-help": "^6",
     "@oclif/plugin-not-found": "^3.2.77",
     "@oclif/plugin-plugins": "^5",
-    "@oclif/plugin-warn-if-update-available": "^3.1.57"
+    "@oclif/plugin-warn-if-update-available": "^3.1.57",
+    "playwright-core": "^1.58.2",
+    "turndown": "^7.2.2"
   },
   "devDependencies": {
     "@eslint/compat": "^1",
@@ -23,6 +25,7 @@
     "@types/chai": "^4",
     "@types/mocha": "^10",
     "@types/node": "^18",
+    "@types/turndown": "^5.0.6",
     "chai": "^4",
     "eslint": "^9",
     "eslint-config-oclif": "^6",
@@ -81,10 +84,9 @@
     "lint": "eslint",
     "postpack": "shx rm -f oclif.manifest.json",
     "posttest": "pnpm run lint",
-    "prepack": "oclif manifest && oclif readme",
+    "prepack": "oclif manifest",
     "pretest": "pnpm run build",
-    "test": "mocha --forbid-only \"test/**/*.test.ts\"",
-    "version": "oclif readme && git add README.md"
+    "test": "mocha --forbid-only \"test/**/*.test.ts\""
   },
   "types": "dist/index.d.ts"
 }