@bugbug-io/cli 14.0.7 → 14.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,99 +1,63 @@
1
- <div align="center">
2
-
3
- ![BugBug Logo](https://bugbug.io/favicon-96x96.png)
1
+ ![BugBug logo](https://bugbug.io/favicon-96x96.png)
4
2
 
5
3
  # BugBug CLI
6
4
 
7
- An enhanced command-line interface for [BugBug](https://bugbug.io) that provides better developer experience and extended capabilities for browser test automation.
8
-
9
- </div>
10
-
11
- ## Features
5
+ ## Requirements
12
6
 
13
- - **Rich Terminal UI**: Interactive navigator and readable error messages built with Ink
14
- - **Flexible Token Management**: Multiple ways to configure your API token (CLI flags, `bugbug.yaml`, environment variables, and `bugbug login`)
15
- - **Project Export & Import**: Export your entire project (tests, suites, profiles) to a ZIP archive and import it back
16
- - **Test & Suite Execution**: Run individual tests or entire test suites in the cloud, waiting for results by default
17
- - **Reporters**: Inline or JUnit XML reports for CI pipelines
18
- - **Verbose Logging**: Optional detailed HTTP request logging for debugging
7
+ - Node.js v24 or higher
8
+ - BugBug account or API token
19
9
 
20
- ## Installation
10
+ ## Install the CLI
21
11
 
22
- ```bash
12
+ ```sh
23
13
  npm install -g @bugbug-io/cli
24
14
  bugbug --help
25
15
  ```
26
16
 
27
- Or run it without installing:
17
+ Or run it without a global install:
28
18
 
29
- ```bash
19
+ ```sh
30
20
  npx @bugbug-io/cli --help
31
21
  ```
32
22
 
33
- ## Requirements
34
-
35
- - Node.js v24 or higher
36
- - BugBug account or API token
37
-
38
- ## Quick Start
23
+ CLI and MCP access require a BugBug Pro plan or higher. The bundled BugBug
24
+ skills are available on all plans.
39
25
 
40
- 1. **Authenticate** (opens the browser and stores a user token in the global config):
26
+ ## Sign in and run your first test
41
27
 
42
- ```bash
43
- bugbug login
44
- ```
45
-
46
- Or pass a token explicitly with `--token`, `BUGBUG_API_TOKEN`, or `bugbug.yaml` (see [Authentication](#authentication)).
47
-
48
- 2. **Export your project**:
49
-
50
- ```bash
51
- bugbug project export
52
- ```
53
-
54
- 3. **Run a test** (waits for completion by default):
55
- ```bash
56
- bugbug tests run <testId>
57
- ```
58
-
59
- ## Authentication
60
-
61
- The CLI resolves configuration from several layered sources. The first match wins:
62
-
63
- 1. **Command line flag** (highest priority):
64
-
65
- ```bash
66
- bugbug project export --token YOUR_TOKEN
67
- ```
28
+ ```sh
29
+ bugbug login
30
+ bugbug tests run <testId>
31
+ ```
68
32
 
69
- 2. **Environment variable**:
33
+ `bugbug login` opens a browser and stores CLI credentials. For CI or scripted
34
+ use, provide an API token with `--token` or `BUGBUG_API_TOKEN`.
70
35
 
71
- ```bash
72
- export BUGBUG_API_TOKEN=YOUR_TOKEN
73
- ```
36
+ ## Link a repo to a BugBug project
74
37
 
75
- 3. **Local project config file** (`bugbug.yaml` in the current directory or an ancestor):
38
+ Run `bugbug init` inside your repository to pin that directory to one BugBug
39
+ project:
76
40
 
77
- ```yaml
78
- # bugbug.yaml
79
- token: YOUR_TOKEN
80
- projectId: YOUR_PROJECT_ID
81
- apiUrl: https://app.bugbug.io/api/v2
82
- ```
41
+ ```sh
42
+ bugbug init
43
+ ```
83
44
 
84
- 4. **Environment file** (`.env`, or `.env.${NODE_ENV}`, walking up the directory tree):
45
+ Interactively it asks how to authenticate - browser login, or a pasted project
46
+ or organization API token - and then lets you pick the project to link. The
47
+ authentication step is skipped if you already ran `bugbug login`. In CI or any
48
+ non-interactive shell, pass both values instead:
85
49
 
86
- ```bash
87
- BUGBUG_API_TOKEN=YOUR_TOKEN
88
- ```
50
+ ```sh
51
+ bugbug --token <api-token> --project-id <project-id> init
52
+ ```
89
53
 
90
- 5. **Global config** (`~/.bugbug/config.yaml`), populated by `bugbug login`. The token is
91
- looked up by `projectId` (falling back to the stored user token).
54
+ `bugbug project init` is the same command.
92
55
 
93
- Running `bugbug login` starts a local loopback callback, opens BugBug in the
94
- browser, completes the OAuth authorization-code flow, and stores the issued user
95
- token in the global config. `bugbug logout` clears it. Run `bugbug init` in a
96
- project directory to create a `bugbug.yaml` that links current directory/repository with selected BugBug project.
56
+ Init writes `projectId` into a `bugbug.yaml` in the current directory and stores
57
+ the token separately in the global config at `~/.bugbug/config.yaml`, keyed by
58
+ that project. Commands run from that directory - or any subdirectory - then
59
+ resolve the project and token on their own, so `bugbug tests list` needs no
60
+ flags. `bugbug.yaml` is safe to commit; the token is never written to it.
97
61
 
98
62
  ## Environment Variables
99
63
 
@@ -180,15 +144,12 @@ bugbug profiles list # List run profiles
180
144
  ### AI Clients (plugin: MCP + Skills)
181
145
 
182
146
  ```bash
183
- bugbug plugin --agent=cursor # Install skills + MCP into Cursor
184
- bugbug plugin --agent=codex --dry-run # Show what would be installed, writing nothing
147
+ bugbug plugin --agent=<agent>
148
+ bugbug plugin --agent=<agent> --dry-run # Show what would be installed, writing nothing
185
149
  ```
186
150
 
187
151
  Supported `--agent` values: `cursor`, `claude`, `vscode`, `codex`, `copilot`.
188
152
 
189
- The token is resolved from your existing CLI auth (`bugbug login`, `--token`, or
190
- `BUGBUG_API_TOKEN`).
191
-
192
153
  ### Shorthands
193
154
 
194
155
  Verb-first shorthands map onto the namespaced commands above:
@@ -47,7 +47,7 @@ import {
47
47
  waitForSuiteRun,
48
48
  waitForTestRun,
49
49
  writeReportXml
50
- } from "./chunk-SCRXJKR2.js";
50
+ } from "./chunk-6556H2AL.js";
51
51
  import "./chunk-BSHFIPEX.js";
52
52
  import "./chunk-PR4QN5HX.js";
53
53
 
@@ -3298,4 +3298,4 @@ var NavigatorApp = ({ initialRoute, initialRouteState }) => {
3298
3298
  export {
3299
3299
  NavigatorApp
3300
3300
  };
3301
- //# sourceMappingURL=NavigatorApp-2CRHZ45Z.js.map
3301
+ //# sourceMappingURL=NavigatorApp-R47EJJAF.js.map
@@ -5,7 +5,7 @@ var startNavigator = async (opts = {}) => {
5
5
  const [{ render }, React, { NavigatorApp }] = await Promise.all([
6
6
  import("./render-U36YSDSA.js"),
7
7
  import("react"),
8
- import("./NavigatorApp-2CRHZ45Z.js")
8
+ import("./NavigatorApp-R47EJJAF.js")
9
9
  ]);
10
10
  const element = React.createElement(
11
11
  NavigatorApp,
@@ -20,4 +20,4 @@ var startNavigator = async (opts = {}) => {
20
20
  export {
21
21
  startNavigator
22
22
  };
23
- //# sourceMappingURL=app-PSJD5SVX.js.map
23
+ //# sourceMappingURL=app-7OABS5ZT.js.map
@@ -8923,7 +8923,7 @@ var require_main = __commonJS({
8923
8923
  // ../core/package.json
8924
8924
  var package_default = {
8925
8925
  name: "@bugbug-io/core",
8926
- version: "14.0.7",
8926
+ version: "14.0.8",
8927
8927
  private: true,
8928
8928
  type: "module",
8929
8929
  main: "dist/index.js",
@@ -58193,7 +58193,7 @@ var readEnvFiles2 = (cwd) => {
58193
58193
  var buildUserAgent2 = (clientType, version) => `BugBug ${clientType.toUpperCase()} ${version}`;
58194
58194
  var package_default2 = {
58195
58195
  name: "@bugbug-io/core",
58196
- version: "14.0.7",
58196
+ version: "14.0.8",
58197
58197
  private: true,
58198
58198
  type: "module",
58199
58199
  main: "dist/index.js",
@@ -64831,4 +64831,4 @@ export {
64831
64831
  formatErrorMessage,
64832
64832
  showError
64833
64833
  };
64834
- //# sourceMappingURL=chunk-SCRXJKR2.js.map
64834
+ //# sourceMappingURL=chunk-6556H2AL.js.map
package/dist/index.js CHANGED
@@ -51,7 +51,7 @@ import {
51
51
  waitForSuiteRun,
52
52
  waitForTestRun,
53
53
  writeReportXml
54
- } from "./chunk-SCRXJKR2.js";
54
+ } from "./chunk-6556H2AL.js";
55
55
  import "./chunk-BSHFIPEX.js";
56
56
  import "./chunk-PR4QN5HX.js";
57
57
 
@@ -1208,7 +1208,7 @@ program.exitOverride();
1208
1208
  });
1209
1209
  analytics.trackEvent("cli_session_started");
1210
1210
  if (startupMode.type === "commandline" && await shouldRedirectUnauthenticatedCommandToInit(process.argv, hasUsableSession)) {
1211
- const { startNavigator } = await import("./app-PSJD5SVX.js");
1211
+ const { startNavigator } = await import("./app-7OABS5ZT.js");
1212
1212
  await startNavigator({
1213
1213
  initialRoute: "/init",
1214
1214
  initialRouteState: {
@@ -1220,7 +1220,7 @@ program.exitOverride();
1220
1220
  return;
1221
1221
  }
1222
1222
  if (startupMode.type === "navigator") {
1223
- const { startNavigator } = await import("./app-PSJD5SVX.js");
1223
+ const { startNavigator } = await import("./app-7OABS5ZT.js");
1224
1224
  await startNavigator({
1225
1225
  initialRoute: startupMode.route,
1226
1226
  token: config.token,
package/package.json CHANGED
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "@bugbug-io/cli",
3
- "version": "14.0.7",
3
+ "version": "14.0.8",
4
+ "description": "BugBug CLI for test automation, CI workflows, and AI-agent plugin installation",
4
5
  "type": "module",
5
6
  "bin": {
6
7
  "bugbug": "bin/bugbug.mjs"