@qadet/runner 0.5.0 → 0.7.0

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.
Files changed (3) hide show
  1. package/README.md +27 -6
  2. package/package.json +3 -7
  3. package/qadet.mjs +252 -25088
package/README.md CHANGED
@@ -1,22 +1,24 @@
1
1
  # Qadet Runner
2
2
 
3
- Runs the browser tests you start in Qadet, in Chrome on this computer. The AI and the tests live in your Qadet workspace; the runner needs no AI key of its own.
3
+ Runs the browser tests you start in [Qadet](https://qadet.nodellm.dev), in Google Chrome on this computer. Because the browser runs here, Qadet can test apps your computer can reach, including localhost, VPN and staging sites.
4
+
5
+ The AI, the plans and the tests live in your Qadet workspace. The runner needs no AI key, never receives your workspace's key or prompts, and keeps nothing in a `.env` file.
4
6
 
5
7
  ## Requirements
6
8
 
7
9
  - Node.js 22 or newer
8
10
  - Google Chrome
9
- - A runner token from your workspace's **Runner tokens** page
11
+ - A runner token from **Runner tokens** in your Qadet workspace (choose **Set up a runner**)
10
12
 
11
13
  ## Install
12
14
 
13
- Copy the install command from **Runner tokens** in Qadet. It names the runner version your workspace needs, for example:
15
+ Copy the install command from **Runner tokens**. It names the runner version your workspace expects, for example:
14
16
 
15
17
  ```sh
16
- npm install --global @qadet/runner@0.3.1
18
+ npm install --global @qadet/runner@0.6.0
17
19
  ```
18
20
 
19
- When Qadet needs a newer runner, it shows the command to update.
21
+ When your workspace needs a newer runner, the runner prints the update command and **Runner tokens** flags the token.
20
22
 
21
23
  ## Connect and run
22
24
 
@@ -25,4 +27,23 @@ qadet connect # once: asks for your workspace address and token, and checks th
25
27
  qadet agent # whenever you want to run tests; stop it with Ctrl+C
26
28
  ```
27
29
 
28
- `qadet status` checks the connection, and `qadet disconnect` removes it. The token is never shown or stored in your shell history.
30
+ While `qadet agent` runs, the runs you start in Qadet open in Chrome on this computer, one at a time, and report their steps, screenshots and recording back to the workspace.
31
+
32
+ | Command | Does |
33
+ |---|---|
34
+ | `qadet connect` | Saves the workspace address and token for this user. The token is asked for at a prompt, so it never lands in your shell history. |
35
+ | `qadet status` | Checks the connection. |
36
+ | `qadet disconnect` | Removes the saved connection. |
37
+ | `qadet agent` | Takes the runs you start in Qadet. |
38
+ | `qadet help` | Lists every command. |
39
+
40
+ ## Behind a proxy
41
+
42
+ If your network reaches the internet through a proxy, set `HTTPS_PROXY` (or `HTTP_PROXY`). Hosts in `NO_PROXY`, such as an app on localhost, are reached directly.
43
+
44
+ ## Troubleshooting
45
+
46
+ - **Qadet says no runner is connected:** start `qadet agent`, and check `qadet status`. If the token expired or was revoked, create a new one and run `qadet connect` again.
47
+ - **A run says it couldn't reach the app:** open the app's address in Chrome on this computer. If it doesn't open here, the runner can't reach it either; check your VPN and the project's browser access settings in Qadet.
48
+
49
+ More in the docs: https://qadet.nodellm.dev/docs/runner
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@qadet/runner",
3
- "version": "0.5.0",
3
+ "version": "0.7.0",
4
4
  "description": "Runs Qadet tests in Chrome on this computer",
5
5
  "type": "module",
6
6
  "files": [
@@ -13,12 +13,8 @@
13
13
  "engines": {
14
14
  "node": ">=22"
15
15
  },
16
- "repository": {
17
- "type": "git",
18
- "url": "git+https://github.com/eshaiju/qadet.git",
19
- "directory": "runner"
20
- },
21
- "homepage": "https://github.com/eshaiju/qadet#readme",
16
+ "license": "UNLICENSED",
17
+ "homepage": "https://qadet.nodellm.dev/docs/runner",
22
18
  "publishConfig": {
23
19
  "access": "public"
24
20
  },