browse 0.7.0 → 0.7.1

package/dist/commands/skills/find.js

@@ -1,13 +1,14 @@
 import { Args, Flags } from "@oclif/core";
 import { BrowseCommand } from "../../base.js";
-import { outputJson } from "../../lib/output.js";
-import { listCatalogSkills, printSkillRows, prioritizeExactSkillMatch, } from "../../lib/skills/catalog.js";
+import { outputFormatFlags, outputJson, resolveOutputFormat, } from "../../lib/output.js";
+import { exactSkillMatch, listCatalogSkills, outputSkillTable, printSkillDetail, prioritizeExactSkillMatch, } from "../../lib/skills/catalog.js";
 export default class SkillsFind extends BrowseCommand {
     static description = "Find Browse.sh catalog skills by slug, domain, title, description, category, alias, or tag.";
     static examples = [
         "browse skills find yelp",
         "browse skills find reviews",
         "browse skills find yelp.com/extract-reviews",
+        "browse skills find travel --limit 5",
         'browse skills find "restaurant reviews" --json',
     ];
     static args = {
@@ -17,17 +18,34 @@ export default class SkillsFind extends BrowseCommand {
         }),
     };
     static flags = {
-        json: Flags.boolean({
-            description: "Print matching skills as JSON.",
+        ...outputFormatFlags,
+        all: Flags.boolean({
+            description: "Show all matching skills in table output.",
+        }),
+        limit: Flags.integer({
+            default: 25,
+            description: "Maximum matching skills to show in table output.",
+            helpValue: "<count>",
+            min: 1,
         }),
     };
     async run() {
         const { args, flags } = await this.parse(SkillsFind);
         const skills = prioritizeExactSkillMatch(await listCatalogSkills({ query: args.query }), args.query);
-        if (flags.json) {
+        const outputFormat = resolveOutputFormat(flags);
+        if (outputFormat === "json") {
             outputJson({ query: args.query, skills });
             return;
         }
-        printSkillRows(skills, `Skills matching "${args.query}"`);
+        const exactMatch = exactSkillMatch(skills, args.query);
+        if (skills.length === 1 && exactMatch) {
+            printSkillDetail(exactMatch);
+            return;
+        }
+        outputSkillTable(skills, {
+            heading: `Skills matching "${args.query}"`,
+            limit: flags.all ? skills.length : flags.limit,
+            wide: flags.wide,
+        });
     }
 }

package/dist/commands/skills/list.js

@@ -1,25 +1,37 @@
 import { Flags } from "@oclif/core";
 import { BrowseCommand } from "../../base.js";
-import { outputJson } from "../../lib/output.js";
-import { listCatalogSkills, printSkillRows } from "../../lib/skills/catalog.js";
+import { outputFormatFlags, outputJson, resolveOutputFormat, } from "../../lib/output.js";
+import { listCatalogSkills, outputSkillTable, } from "../../lib/skills/catalog.js";
 export default class SkillsList extends BrowseCommand {
     static description = "List Browse.sh catalog skills.";
     static examples = [
         "browse skills list",
+        "browse skills list --limit 10",
+        "browse skills list --all",
         "browse skills list --json",
     ];
     static flags = {
-        json: Flags.boolean({
-            description: "Print skills as JSON.",
+        ...outputFormatFlags,
+        all: Flags.boolean({
+            description: "Show all returned skills in table output.",
+        }),
+        limit: Flags.integer({
+            default: 25,
+            description: "Maximum skills to show in table output.",
+            helpValue: "<count>",
+            min: 1,
         }),
     };
     async run() {
         const { flags } = await this.parse(SkillsList);
         const skills = await listCatalogSkills();
-        if (flags.json) {
+        if (resolveOutputFormat(flags) === "json") {
             outputJson({ skills });
             return;
         }
-        printSkillRows(skills);
+        outputSkillTable(skills, {
+            limit: flags.all ? skills.length : flags.limit,
+            wide: flags.wide,
+        });
     }
 }

package/dist/commands/templates/find.js

@@ -1,13 +1,14 @@
-import { Args, Flags } from "@oclif/core";
+import { Args } from "@oclif/core";
 import { BrowseCommand } from "../../base.js";
-import { outputJson } from "../../lib/output.js";
+import { outputFormatFlags, outputJson, resolveOutputFormat, } from "../../lib/output.js";
 import { getTemplateIfExists, listTemplates } from "../../lib/templates/api.js";
-import { printTemplateDetail, printTemplateRows, templateMatchesQuery, } from "../../lib/templates/output.js";
+import { outputTemplateTable, printTemplateDetail, templateMatchesQuery, } from "../../lib/templates/output.js";
 export default class TemplatesFind extends BrowseCommand {
     static description = "Find Browserbase templates by slug, title, category, or tag.";
     static examples = [
         "browse templates find google-trends-keywords",
         "browse templates find amazon",
+        "browse templates find Python --wide",
         "browse templates find Python --json",
     ];
     static args = {
@@ -17,15 +18,14 @@ export default class TemplatesFind extends BrowseCommand {
         }),
     };
     static flags = {
-        json: Flags.boolean({
-            description: "Print matching templates as JSON.",
-        }),
+        ...outputFormatFlags,
     };
     async run() {
         const { args, flags } = await this.parse(TemplatesFind);
         const exactTemplate = await getTemplateIfExists(args.query);
+        const outputFormat = resolveOutputFormat(flags);
         if (exactTemplate) {
-            if (flags.json) {
+            if (outputFormat === "json") {
                 outputJson({ query: args.query, templates: [exactTemplate] });
                 return;
             }
@@ -34,10 +34,13 @@ export default class TemplatesFind extends BrowseCommand {
         }
         const templates = await listTemplates();
         const matches = templates.filter((template) => templateMatchesQuery(template, args.query));
-        if (flags.json) {
+        if (outputFormat === "json") {
             outputJson({ query: args.query, templates: matches });
             return;
         }
-        printTemplateRows(matches, `Templates matching "${args.query}"`);
+        outputTemplateTable(matches, {
+            heading: `Templates matching "${args.query}"`,
+            wide: flags.wide,
+        });
     }
 }

package/dist/commands/templates/list.js

@@ -1,24 +1,23 @@
 import { Flags } from "@oclif/core";
 import { BrowseCommand } from "../../base.js";
-import { outputJson } from "../../lib/output.js";
+import { outputFormatFlags, outputJson, resolveOutputFormat, } from "../../lib/output.js";
 import { listTemplates } from "../../lib/templates/api.js";
-import { printTemplateRows } from "../../lib/templates/output.js";
+import { outputTemplateTable } from "../../lib/templates/output.js";
 export default class TemplatesList extends BrowseCommand {
     static description = "List Browserbase templates.";
     static examples = [
         "browse templates list",
         'browse templates list --category "Web Automation"',
         "browse templates list --tag Python --source Browserbase",
+        "browse templates list --wide",
         "browse templates list --json",
     ];
     static flags = {
+        ...outputFormatFlags,
         category: Flags.string({
             description: "Filter templates by category.",
             helpValue: "<category>",
         }),
-        json: Flags.boolean({
-            description: "Print templates as JSON.",
-        }),
         source: Flags.string({
             description: "Filter templates by source.",
             helpValue: "<source>",
@@ -35,10 +34,10 @@ export default class TemplatesList extends BrowseCommand {
             source: flags.source,
             tag: flags.tag,
         });
-        if (flags.json) {
+        if (resolveOutputFormat(flags) === "json") {
             outputJson({ templates });
             return;
         }
-        printTemplateRows(templates);
+        outputTemplateTable(templates, { wide: flags.wide });
     }
 }

package/dist/lib/skills/catalog.js

@@ -1,4 +1,5 @@
 import { fail } from "../errors.js";
+import { outputTable } from "../output.js";
 import { defaultSkillsApiBaseUrl, isRecord, responseDetail } from "./shared.js";
 export async function listCatalogSkills(options = {}) {
     const payload = await requestSkillsJson(skillsCatalogApiUrl(options.query));
@@ -14,24 +15,70 @@ export function prioritizeExactSkillMatch(skills, query) {
         return aExact ? -1 : 1;
     });
 }
-export function printSkillRows(skills, heading = "Skills") {
-    if (skills.length === 0) {
+export function outputSkillTable(skills, options = {}) {
+    const visibleSkills = skills.slice(0, options.limit ?? skills.length);
+    if (visibleSkills.length === 0) {
         console.log("No skills found.");
         return;
     }
-    console.log(`${heading} (${skills.length})`);
-    for (const skill of skills) {
-        console.log(`\n${skill.slug}  ${skill.title}`);
-        if (skill.description) {
-            console.log(`  ${skill.description}`);
-        }
-        console.log(`  method: ${skill.recommendedMethod} | source: ${skill.source || "-"} | installs: ${skill.installCount}`);
-        if (skill.tags.length > 0) {
-            console.log(`  tags: ${skill.tags.join(", ")}`);
-        }
-        console.log(`  install: browse skills add ${skill.slug}`);
+    if (options.heading) {
+        console.log(`${options.heading} (${skills.length})`);
+    }
+    outputTable(visibleSkills, [
+        {
+            header: "Skill",
+            maxWidth: 42,
+            value: (skill) => skill.slug,
+        },
+        {
+            header: "Title",
+            maxWidth: 42,
+            value: (skill) => skill.title,
+        },
+        {
+            header: "Method",
+            maxWidth: 7,
+            value: (skill) => skill.recommendedMethod,
+        },
+        {
+            align: "right",
+            header: "Installs",
+            maxWidth: 8,
+            value: (skill) => skill.installCount,
+        },
+        {
+            header: "Tags",
+            maxWidth: 36,
+            value: (skill) => formatList(skill.tags),
+        },
+    ], { wide: options.wide });
+    console.log("Install with: browse skills add <skill>");
+    if (visibleSkills.length < skills.length) {
+        console.log(`Showing ${visibleSkills.length} of ${skills.length} skills. Use --limit, --all, --wide, or --json.`);
+    }
+    else {
+        console.log("Use --wide for full values or --json for full descriptions.");
     }
 }
+export function printSkillDetail(skill) {
+    console.log(skill.title);
+    console.log(`Skill: ${skill.slug}`);
+    console.log(`Method: ${skill.recommendedMethod}`);
+    console.log(`Source: ${skill.source || "-"}`);
+    console.log(`Installs: ${skill.installCount}`);
+    console.log(`Tags: ${formatList(skill.tags)}`);
+    if (skill.description) {
+        console.log(`\n${skill.description}`);
+    }
+    console.log(`\nInstall: browse skills add ${skill.slug}`);
+}
+export function exactSkillMatch(skills, query) {
+    const normalizedQuery = query.toLowerCase();
+    return skills.find((skill) => skill.slug.toLowerCase() === normalizedQuery);
+}
+function formatList(values) {
+    return values.length > 0 ? values.join(", ") : "-";
+}
 function skillsCatalogApiUrl(query) {
     const baseUrl = process.env.BROWSE_SKILLS_API_BASE_URL || defaultSkillsApiBaseUrl;
     const url = new URL("api/skills", baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`);

package/dist/lib/templates/output.js

@@ -1,16 +1,40 @@
-export function printTemplateRows(templates, heading = "Templates") {
+import { outputTable } from "../output.js";
+export function outputTemplateTable(templates, options = {}) {
     if (templates.length === 0) {
         console.log("No templates found.");
         return;
     }
-    console.log(`${heading} (${templates.length})`);
-    for (const template of templates) {
-        console.log(`${template.slug}  ${template.title}`);
-        if (template.shortDescription) {
-            console.log(`  ${template.shortDescription}`);
-        }
-        console.log(`  source: ${template.source ?? "-"} | categories: ${formatList(template.category)} | tags: ${formatList(template.tags)}`);
+    if (options.heading) {
+        console.log(`${options.heading} (${templates.length})`);
     }
+    outputTable(templates, [
+        {
+            header: "Template",
+            maxWidth: 34,
+            value: (template) => template.slug,
+        },
+        {
+            header: "Title",
+            maxWidth: 42,
+            value: (template) => template.title,
+        },
+        {
+            header: "Source",
+            maxWidth: 12,
+            value: (template) => template.source,
+        },
+        {
+            header: "Categories",
+            maxWidth: 34,
+            value: (template) => formatList(template.category),
+        },
+        {
+            header: "Tags",
+            maxWidth: 34,
+            value: (template) => formatList(template.tags),
+        },
+    ], { wide: options.wide });
+    console.log("Use --wide for full values or --json for full descriptions.");
 }
 export function printTemplateDetail(template) {
     console.log(`${template.title}`);