@browserbasehq/cli 0.0.1 → 0.2.1

package/dist/cli.js

@@ -1,5 +1,8 @@
+import { createRequire } from "node:module";
 import { Command, CommanderError } from "commander";
 import { attachBrowseCommand } from "./commands/browse.js";
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
 import { attachContextsCommand } from "./commands/contexts.js";
 import { attachDashboardCommand } from "./commands/dashboard.js";
 import { attachExtensionsCommand } from "./commands/extensions.js";
@@ -7,25 +10,27 @@ import { attachFetchCommand } from "./commands/fetch.js";
 import { attachFunctionsCommand } from "./commands/functions.js";
 import { attachProjectsCommand } from "./commands/projects.js";
 import { attachSessionsCommand } from "./commands/sessions.js";
+import { attachSkillsCommand } from "./commands/skills.js";
 export function buildProgram() {
     const program = new Command();
     program
         .name("bb")
         .description("Browserbase CLI for platform APIs, functions, and browse passthrough.")
-        .version("0.1.0")
+        .version(version)
         .helpCommand(false)
         .showHelpAfterError()
         .showSuggestionAfterError()
         .enablePositionalOptions()
         .exitOverride();
-    attachDashboardCommand(program);
     attachBrowseCommand(program);
-    attachFunctionsCommand(program);
+    attachFetchCommand(program);
     attachSessionsCommand(program);
+    attachDashboardCommand(program);
+    attachFunctionsCommand(program);
     attachProjectsCommand(program);
     attachContextsCommand(program);
     attachExtensionsCommand(program);
-    attachFetchCommand(program);
+    attachSkillsCommand(program);
     return program;
 }
 export async function run(argv) {

package/dist/commands/browse.js

@@ -3,7 +3,7 @@ import { findExecutable, spawnPassthrough } from "../lib/process.js";
 export function attachBrowseCommand(program) {
     program
         .command("browse")
-        .description("Forward commands to the standalone @browserbasehq/browse-cli binary.")
+        .description("Run and interact with a local or remote browser. Navigate to pages, send clicks, keystrokes, take screenshots, get a11y trees, and more.")
         .argument("[args...]", "Arguments to forward to browse")
         .allowUnknownOption(true)
         .allowExcessArguments(true)

package/dist/commands/contexts.js

@@ -2,7 +2,7 @@ import { addCommonApiOptions, createBrowserbaseClient, mergeProjectIdIntoBody, o
 export function attachContextsCommand(program) {
     const contexts = program
         .command("contexts")
-        .description("Create, inspect, update, and delete Browserbase contexts.")
+        .description("Contexts allow you to persist user data across multiple browser sessions, enabling smoother automation, seamless authentication, and faster end-to-end workflows.")
         .helpCommand(false);
     contexts.action(() => {
         contexts.outputHelp();

package/dist/commands/dashboard.js

@@ -2,7 +2,7 @@ import { openUrl } from "../lib/open.js";
 export function attachDashboardCommand(program) {
     program
         .command("dashboard")
-        .description("Open Browserbase Overview in your local browser.")
+        .description("Open the Browserbase web dashboard for your project.")
         .action(async () => {
         const url = "http://browserbase.com/overview";
         await openUrl(url);

package/dist/commands/extensions.js

@@ -2,7 +2,7 @@ import { addCommonApiOptions, createBrowserbaseClient, outputJson, requestBrowse
 export function attachExtensionsCommand(program) {
     const extensions = program
         .command("extensions")
-        .description("Upload and manage Browserbase extensions.")
+        .description("Install Chrome extensions onto remote Browserbase sessions.")
         .helpCommand(false);
     extensions.action(() => {
         extensions.outputHelp();

package/dist/commands/fetch.js

@@ -2,7 +2,7 @@ import { addCommonApiOptions, createBrowserbaseClient, outputJson, writeOutputFi
 export function attachFetchCommand(program) {
     addCommonApiOptions(program
         .command("fetch <url>")
-        .description("Fetch a page with the Browserbase Fetch API.")
+        .description("Retrieve webpage content without a full browser session using the lightweight Browserbase Fetch API.")
         .option("--allow-insecure-ssl", "Bypass TLS certificate verification.")
         .option("--allow-redirects", "Follow HTTP redirects.")
         .option("--proxies", "Enable Browserbase proxy support.")

package/dist/commands/functions.js

@@ -8,7 +8,7 @@ const packageManagers = ["npm", "pnpm"];
 export function attachFunctionsCommand(program) {
     const functions = program
         .command("functions")
-        .description("Develop, publish, and invoke Browserbase Functions.")
+        .description("Write and deploy web automation scripts to Browserbase cloud Functions.")
         .helpCommand(false);
     functions.action(() => {
         functions.outputHelp();

package/dist/commands/projects.js

@@ -2,7 +2,7 @@ import { addCommonApiOptions, createBrowserbaseClient, outputJson } from "../lib
 export function attachProjectsCommand(program) {
     const projects = program
         .command("projects")
-        .description("List and inspect Browserbase projects.")
+        .description("Manage your Browserbase projects.")
         .helpCommand(false);
     projects.action(() => {
         projects.outputHelp();

package/dist/commands/sessions.js

@@ -3,7 +3,7 @@ import { addCommonApiOptions, createBrowserbaseClient, fail, mergeProjectIdIntoB
 export function attachSessionsCommand(program) {
     const sessions = program
         .command("sessions")
-        .description("Create, inspect, and manage Browserbase sessions.")
+        .description("Manage your remote browser sessions on Browserbase. Create, update, list, and read logs.")
         .helpCommand(false);
     sessions.action(() => {
         sessions.outputHelp();

package/dist/commands/skills.js

@@ -0,0 +1,60 @@
+import * as readline from "node:readline/promises";
+import { fail } from "../lib/command.js";
+import { findExecutable, spawnPassthrough } from "../lib/process.js";
+async function installSkills() {
+    const npxPath = await findExecutable("npx");
+    if (!npxPath) {
+        fail([
+            "`npx` is not installed.",
+            "Install Node.js from https://nodejs.org to get npx,",
+            "then rerun `bb skills`.",
+        ].join("\n"));
+    }
+    const exitCode = await spawnPassthrough(npxPath, [
+        "skills",
+        "add",
+        "browserbase/skills",
+        "--yes",
+        "--global",
+    ]);
+    if (exitCode !== 0) {
+        process.exitCode = exitCode;
+    }
+}
+export function attachSkillsCommand(program) {
+    const skills = program
+        .command("skills")
+        .description("Install Browserbase agent skills for Claude Code.")
+        .action(async () => {
+        console.log([
+            "",
+            "Browserbase Skills for Claude Code",
+            "===================================",
+            "",
+            "Skills teach Claude Code how to use Browserbase features like",
+            "browsing, sessions, functions, and more.",
+            "",
+            "  Source:  https://github.com/browserbase/skills",
+            "  Run:    npx skills add browserbase/skills --yes --global",
+            "",
+        ].join("\n"));
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        try {
+            const answer = await rl.question("Install skills? [Y/n] ");
+            if (answer.trim().toLowerCase() === "n") {
+                return;
+            }
+        }
+        finally {
+            rl.close();
+        }
+        await installSkills();
+    });
+    skills
+        .command("install")
+        .description("Install Browserbase agent skills globally via npx (non-interactive).")
+        .action(installSkills);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/cli",
-  "version": "0.0.1",
+  "version": "0.2.1",
   "description": "Browserbase CLI for platform APIs, functions, and browse passthrough.",
   "type": "module",
   "private": false,