@botdocs/cli 0.11.0 → 0.12.1

package/dist/commands/ingest.d.ts

@@ -21,6 +21,11 @@ interface IngestOptions {
     pair?: boolean;
     /** Pre-supplied pairing code (BD-XXXXX). Implies `--pair`. */
     pairCode?: string;
+    /** Suppress the auto-open of https://botdocs.ai/pair when `--pair` is
+     * set. Necessary for headless / SSH / CI use where launching a browser
+     * is either pointless or actively harmful. Mirrors the same opt-out we
+     * want long-term on `botdocs login`. */
+    noBrowser?: boolean;
 }
 /** Per-file size cap. Any file larger than this is skipped with a warning. */
 export declare const PER_FILE_BYTE_CAP: number;

package/dist/commands/ingest.js

@@ -3,7 +3,8 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { render } from 'ink';
-import { ApiError, apiFetch } from '../lib/api.js';
+import open from 'open';
+import { ApiError, apiFetch, getApiUrl } from '../lib/api.js';
 import { loadAuth } from '../lib/config.js';
 import { IngestSessionClient, PairingClaimError } from '../lib/ingest-session-client.js';
 import { discoverSkills, ecosystemLabel, formatBytes, STUB_BYTE_THRESHOLD, summaryKey, titleFromContent, } from '../lib/ingest-discover.js';
@@ -949,7 +950,44 @@ async function setupPairingIfRequested(options) {
     }
     let code = options.pairCode;
     if (!code) {
-        const entered = await readLine('  Enter pairing code from the onboarding page: ');
+        // Auto-open the pairing page in the user's default browser unless they
+        // opted out via --no-browser. The page mints (or reuses) the BD-XXXXX
+        // code server-side, so by the time the browser tab loads, the code is
+        // already on screen — no waiting, no second click.
+        //
+        // We open BEFORE printing the prompt so the order of events feels right
+        // ("browser opens, look there, paste here"). If `open()` fails — common
+        // in headless / SSH / CI environments — we swallow the error and fall
+        // back to the printed URL. The CLI must never become unusable because
+        // we couldn't reach a graphical browser.
+        const pairUrl = `${getApiUrl()}/pair`;
+        const shouldOpen = options.noBrowser !== true;
+        let browserOpened = false;
+        if (shouldOpen) {
+            try {
+                await open(pairUrl);
+                browserOpened = true;
+            }
+            catch {
+                /* swallow — fall back to the printed URL below */
+            }
+        }
+        console.log('');
+        if (browserOpened) {
+            console.log(`  ✓ Opened ${pairUrl} in your browser.`);
+            console.log('    Copy the BD-XXXXX code shown there and paste it here.');
+        }
+        else {
+            console.log(`  Get your pairing code at ${pairUrl}`);
+            if (!shouldOpen) {
+                console.log('    (--no-browser is set; visit the URL above manually.)');
+            }
+            else {
+                console.log("    (Browser open failed — open the URL above manually.)");
+            }
+        }
+        console.log('');
+        const entered = await readLine('  Pairing code: ');
         if (!entered) {
             console.log('  → Pairing skipped (no code entered).');
             return null;

package/dist/commands/views/ingest-discover-app.js

@@ -159,7 +159,14 @@ export function IngestDiscoverApp(props) {
     if (files.length === 0) {
         return (_jsx(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: _jsx(Text, { children: "No skills found in any known location." }) }));
     }
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: [_jsx(Text, { bold: true, color: theme.cyan, children: "BotDocs ingest" }), _jsxs(Text, { color: theme.zinc, children: ["Found ", files.length, " skill", files.length === 1 ? '' : 's', " across", ' ', countEcosystems(files), " tool", countEcosystems(files) === 1 ? '' : 's', ":"] }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: rows.map((row, i) => {
+    // The header summarizes SKILLS, not raw files. A multi-file skill
+    // (e.g. a SKILL.md with helper scripts in scripts/) is one row in the
+    // list — and should be one tick in the count too. Previously we used
+    // `files.length` here, which counted every adjacent file separately
+    // and inflated the total ~3× on typical libraries.
+    const skillCount = useMemo(() => files.filter(isRootFile).length, [files]);
+    const toolCount = useMemo(() => countEcosystems(files), [files]);
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: [_jsx(Text, { bold: true, color: theme.cyan, children: "BotDocs ingest" }), _jsxs(Text, { color: theme.zinc, children: ["Found ", skillCount, " skill", skillCount === 1 ? '' : 's', " across", ' ', toolCount, " tool", toolCount === 1 ? '' : 's', ":"] }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: rows.map((row, i) => {
                     if (row.kind === 'header') {
                         return (_jsx(Box, { marginTop: i === 0 ? 0 : 1, children: _jsxs(Text, { bold: true, color: theme.violet, children: [ecosystemLabel(row.ecosystem), ":"] }) }, `h-${row.ecosystem}`));
                     }

package/dist/commands/views/login-app.js

@@ -3,16 +3,17 @@ import { useEffect, useState } from 'react';
 import { Box, Text, useApp } from 'ink';
 import Spinner from 'ink-spinner';
 import Gradient from 'ink-gradient';
-import BigText from 'ink-big-text';
 import { theme, BIG_TEXT_MIN_COLS } from './theme.js';
-/** Brand wordmark. Falls back to a bold plain "botdocs" on narrow terminals
- * where ASCII art would wrap. The `tiny` font keeps the cap height low so the
- * screen stays scannable. */
+/** Brand wordmark. A gradient bold "botdocs" on roomy terminals, falling back
+ * to a plain bold cyan "botdocs" on narrow ones. (Previously this rendered an
+ * ink-big-text ASCII wordmark, but that pulled GPL-3.0 `cfonts` into a package
+ * published under MIT — see [G-3]. A styled plain wordmark keeps the brand
+ * without the license conflict.) */
 function BrandMark({ columns }) {
     if (columns < BIG_TEXT_MIN_COLS) {
         return (_jsx(Text, { bold: true, color: theme.cyan, children: "botdocs" }));
     }
-    return (_jsx(Gradient, { colors: [theme.cyan, theme.violet], children: _jsx(BigText, { text: "botdocs", font: "tiny" }) }));
+    return (_jsx(Gradient, { colors: [theme.cyan, theme.violet], children: _jsx(Text, { bold: true, children: "botdocs" }) }));
 }
 /** Single source of truth for active-state lines. Returns a label + spinner
  * pair the renderer can drop into the layout — keeps the state-string mapping

package/dist/commands/views/theme.d.ts

@@ -9,8 +9,7 @@ export declare const theme: {
     readonly red: "#f87171";
     readonly zinc: "#71717a";
 };
-/** Width below which we skip the `ink-big-text` ASCII wordmark and fall back
- * to a plain bold "botdocs" line — narrower terminals render the big-text
- * with awkward wrapping. 60 was chosen empirically: a 50-column wordmark plus
- * margins fits comfortably above that. */
+/** Width at/above which the login wordmark renders with the cyan→violet
+ * gradient; narrower terminals fall back to a plain bold cyan "botdocs". 60
+ * was chosen empirically so the wordmark plus margins fits comfortably. */
 export declare const BIG_TEXT_MIN_COLS = 60;

package/dist/commands/views/theme.js

@@ -9,8 +9,7 @@ export const theme = {
     red: '#f87171', // Tailwind red-400 — error
     zinc: '#71717a', // Tailwind zinc-500 — subtle / hint
 };
-/** Width below which we skip the `ink-big-text` ASCII wordmark and fall back
- * to a plain bold "botdocs" line — narrower terminals render the big-text
- * with awkward wrapping. 60 was chosen empirically: a 50-column wordmark plus
- * margins fits comfortably above that. */
+/** Width at/above which the login wordmark renders with the cyan→violet
+ * gradient; narrower terminals fall back to a plain bold cyan "botdocs". 60
+ * was chosen empirically so the wordmark plus margins fits comfortably. */
 export const BIG_TEXT_MIN_COLS = 60;

package/dist/index.js

@@ -301,11 +301,18 @@ program
     .option('--no-ink', 'Disable the interactive TUI; use plain output (zero-arg mode only)')
     .option('--pair', "Pair with the web onboarding step so it can mirror this ingest live; prompts for a BD-XXXXX code")
     .option('--pair-code <code>', 'Pre-supply the pairing code (e.g. BD-A4F8K) — skips the interactive prompt; implies --pair')
+    .option('--no-browser', 'With --pair: do NOT auto-open https://botdocs.ai/pair (for SSH / CI / headless use)')
     .action(async (sourcePath, opts) => {
-    // Commander's --no-ink convention sets opts.ink = false; flip to noInk
-    // so downstream consumers don't have to handle the inverted boolean.
-    const { ink, ...rest } = opts;
-    await ingest(sourcePath, { ...rest, noInk: ink === false, json: program.opts().json });
+    // Commander's --no-* convention sets opts.<name> = false; flip both
+    // negated flags to their `noX` siblings so downstream consumers don't
+    // have to handle the inverted boolean each time.
+    const { ink, browser, ...rest } = opts;
+    await ingest(sourcePath, {
+        ...rest,
+        noInk: ink === false,
+        noBrowser: browser === false,
+        json: program.opts().json,
+    });
 });
 program
     .command('compile <path>')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botdocs/cli",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "description": "CLI for BotDocs — author, publish, install, and sync agent skills across Claude, Claude Code, Cursor, Codex, ChatGPT, Windsurf, Copilot, Gemini, Antigravity, and OpenCode.",
   "keywords": [
     "botdocs",
@@ -68,7 +68,6 @@
     "commander": "^14.0.3",
     "diff": "^9.0.0",
     "ink": "^5.2.1",
-    "ink-big-text": "^2.0.0",
     "ink-gradient": "^3.0.0",
     "ink-select-input": "^6.2.0",
     "ink-spinner": "^5.0.0",