genclass 0.2.2 → 0.3.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 (4) hide show
  1. package/CHANGELOG.md +118 -0
  2. package/README.md +157 -32
  3. package/dist/genclass.mjs +6289 -3278
  4. package/package.json +3 -3
package/CHANGELOG.md CHANGED
@@ -1,5 +1,123 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.3.0
4
+
5
+ The command becomes the whole product in a terminal. Until now it set GenClass up and ended; what the dashboard
6
+ shows, and everything an account can do, needed the browser.
7
+
8
+ - **It stays open.** When the walk is done, or left with `q`, the command asks what next: type a command
9
+ (`problems`, `analytics`, `fix`, ...) or a sentence, which is a question about your app. `q` leaves. Inside it a
10
+ view is not headed again by the card. A command typed whole, as a screen printed it (`npx genclass fix`), works
11
+ there too.
12
+ - **Just `genclass`.** `npx genclass` runs without installing, so `genclass` alone was "command not found". The
13
+ first time the home opens, the command offers to install itself (`npm install -g genclass`, shown first, asked
14
+ once, never in CI or with `--yes`). Once `genclass` is on the PATH every screen says `genclass` instead of
15
+ `npx genclass`.
16
+ - **Every part of the dashboard.** `problems` (by kind, by page, each kind on each page, the measured visual
17
+ checks, what GenClass stopped on the visitor's screen, the change on the period before), `analytics` (visits,
18
+ page views, time on a page, pages, sources and campaigns, devices, browsers, systems, countries, new and
19
+ returning, clicks, rage clicks and dead clicks, paths, entry and exit pages, funnels; one part in full with
20
+ `analytics pages` and so on), `events` (the latest 50 as stored, with mode and trigger under `--all`), `health`
21
+ (model loads, where it ran, decision time, what was not checked, load errors, the visual checks' coverage, runtime
22
+ versions; `--all` adds every breakdown), `report` (the dashboard's Copy as Markdown), `export` (every stored
23
+ event as JSON Lines or CSV, page by page into one file). All of them fit a 58-column window, take `--range`,
24
+ `--app`, `--all` and `--json`, and follow the plan's rules like the browser does.
25
+ - **`fix`: the problems, handed to your coding agent.** The list, a pick (a number, a kind, or all), and Enter starts
26
+ Claude Code, Codex, Cursor's agent or Gemini CLI in the project with the dashboard's own prompt for it: what, where,
27
+ the usual fix, and the steps that reproduce it and prove the fix with GenClass's MCP server. `c` copies, `p`
28
+ prints, `--print` prints and nothing else. GenClass changes no code and starts nothing without a key press.
29
+ - **`ask`: talk to it.** A question in plain words is answered by genclass.dev's model from the app's dashboard
30
+ numbers; a follow-up carries the turn before it. Only the question leaves the machine; the first time, the command
31
+ says what goes to the model and waits for Enter. It shares a plan's daily model runs with `suggest`.
32
+ - **The account's side.** `connections` (where alerts go: Slack, Sentry, PostHog, Datadog, a webhook; add, test,
33
+ turn off, remove, with what is typed never shown; plus the GitHub App, the coding agent and the private link),
34
+ `agent` (how the agent is connected here and what it did with the findings) and `agent link` (gives the agent the
35
+ live site's numbers, in your own agent settings, not in the repository), `funnels` (add and remove), `apps`
36
+ (list, new), `plan` (limits, what is used, what the plan leaves out, and Enter to start the paid plan), `team`
37
+ (who is on it, an invite link).
38
+ - **A plan is chosen at the start of the setup.** For an account on Free the step after the sign-in shows the paid
39
+ plan, large, with its price and what it adds; Enter opens its checkout in the browser (one click less: the page
40
+ goes straight to Stripe), `f` is "Try free for now (limited)". Asked once per project.
41
+ - **What a terminal may do is listed where it is approved.** The sign-in page now lists it line by line, and what
42
+ it never can: change how you sign in, pay, remove people, delete an app or the account. A sign-in from before
43
+ this version was approved for less: the first command that needs more says so and signs in again on Enter.
44
+ - Notes and lists no longer run two columns past a 58-column window; a share of almost all is no longer rounded up
45
+ to "100%"; two apps with the same name can be told apart (`--app <id>`).
46
+
47
+ ## 0.2.4
48
+
49
+ - **A repository that was renamed on GitHub is found under its new name.** A checkout cloned before a rename still
50
+ carries the old name in its remote, and genclass.dev knows the repository by the current one, so the GitHub App
51
+ step said "not on acme/shop-old yet" for an app that was installed and reviewing. When the server answers "not
52
+ installed", the command asks github.com where the old address leads now (one HEAD request, public repositories
53
+ only) and asks again under that name. The step's details say the new name and the line that updates the remote.
54
+ Found on GenClass's own repository the first time the step was run against GitHub.
55
+
56
+ ## 0.2.3
57
+
58
+ From using the command on a real site the morning after 0.2.2, and from watching its owner use it:
59
+
60
+ - **A new first screen.** On a terminal the command opens with a welcome card: its name and version in the border,
61
+ "Welcome back, Ada!" (or, signed out, what GenClass does in two lines), GenClass's logo as pixel art (the green
62
+ arrow over the top, the red arrow underneath, in the logo's own two greens and two reds), and three quiet lines for
63
+ the app, the account and the folder. It fits a 58-column window, where the old block-letter wordmark never showed.
64
+ What comes next stands beside a green bar, and the question is one line under a rule: `❯ Enter to continue · d
65
+ every part · s skip · q stop`. Piped output and `--json` are as plain as before.
66
+ - **An app on Vite 7 or earlier builds again.** Found by installing into a fresh Vite 7 app and running its
67
+ build: `vite build` failed with `Invalid value "iife" for option "worker.format"` once GenClass was in it, because
68
+ Vite before 8 bundles a worker as one classic script and the model's worker cannot be one. Every app in GenClass's
69
+ own repository is on Vite 8, so this was never seen. The runtime step now shows and writes the two settings such
70
+ an app needs (`worker: { format: "es" }` for the build, `optimizeDeps: { exclude: ["@genclass/runtime"] }` so the
71
+ dev server runs the model in a worker instead of on the page's thread), as the first keys of your Vite config,
72
+ with its own marker. An app that already has GenClass gets "Add two Vite settings" as its next step. A config it
73
+ cannot edit without guessing (a function, one that sets `worker` itself, an app with workers of its own) is left
74
+ alone and gets the two lines to add by hand. `remove` takes them out. Vite 8 needs nothing and gets nothing.
75
+ - **`npx genclass dashboard`, after seeing it on a real account:** the list is largest first whatever order the
76
+ server sends, and leads with what happened in plain words ("old data replaced newer data", then the page) instead
77
+ of the kind's name and a cut-off explanation; `--all` adds the kind's own name. The first number is "Page loads",
78
+ the dashboard page's own word (it said "Visits watched" next to a different "visits" under Visitors). The chart of
79
+ problems has a line of its own and folds a long period to the window. Long lines fold; nothing ends in "…".
80
+ - **`npx genclass remove` takes out everything GenClass put in the project.** After the runtime (the import, the
81
+ config file, the package) it lists what the other steps wrote and removes it on one more yes: GenClass's entry
82
+ in `.mcp.json` (your other servers stay; the file goes only when that entry was all it held), the skill (only
83
+ while it still carries its marker), the pull-request workflow (only while it is exactly the file this command
84
+ wrote) and `.genclass/`, where the coding agent's tools keep what they recorded. What you made your own is kept
85
+ and named. Your app stays in your account.
86
+ - **From walking the whole setup as a new user, twice, on a real terminal at 80 and 58 columns:**
87
+ - A sign-in that did not finish (the code expired, the browser said no) is offered once more instead of the walk
88
+ moving on without an account.
89
+ - The sign-in step says where a new person's account comes from ("New here? Your free account is made there").
90
+ - Nothing runs past a narrow window any more: the runtime step's lines, the suggestions (a long evidence line
91
+ wraps instead of ending in "…"), the list of steps, the day-to-day commands. A command or an address is never
92
+ split across two lines.
93
+ - Suggestions no longer list the internal names of checks that need your site ("Not checked (20): https,
94
+ www-joined, ..."); it says how many there are and how to get them.
95
+ - **Every command it names is one you can run.** The screens said `genclass suggest`, which is "command not found"
96
+ for anyone who started with `npx genclass` and has nothing installed. They now say `npx genclass suggest`, in the
97
+ views, the help and the `run` fields of `--json`. The help says how to get the short name
98
+ (`npm install -g genclass`).
99
+ - **A folder that is not a web app is no longer a dead end.** In a monorepo's root, or the folder above the app, the
100
+ command lists the web apps it finds below (three folders deep, eight named) with the command for each, and on a
101
+ terminal it asks which one and carries on there. `status --json` carries the list as `app.below`.
102
+ - A mistyped command names the nearest one: `genclass dashbord` says "Did you mean npx genclass dashboard?".
103
+ - **`genclass login` signs in again when it has to.** With a sign-in from before the command could show dashboards,
104
+ `genclass dashboard` said "run genclass login" and `genclass login` answered "already signed in". It now says what
105
+ is missing and asks for one more approval in the browser.
106
+ - **`genclass scan --local` works.** The command carries no copy of the runtime, so it uses the one installed in the
107
+ project (`node_modules/@genclass/runtime`, in this folder or one above it). When there is none it says what to
108
+ install, instead of naming a build step of GenClass's own repository.
109
+ - **`genclass scan` waits for a scan of the same page that is already running** (someone else's, or yours a moment
110
+ ago) and prints that scan's report, instead of stopping with "try again in 20 s".
111
+ - **A normal page is not told its check "could not finish".** A page with no search box and no form gives the race
112
+ probe nothing to try; that row now reads "nothing to try on this page" and does not count as a part that failed.
113
+ - **A page check that could not finish says so next to the score.** On a heavy page the hosted check runs out of
114
+ time, and the report read "Score 83/100" with five of eight parts not measured further down. It now reads
115
+ "Score 83/100 over 3 of 8 parts", says which parts the score covers and why, and gives the command that runs the
116
+ visual checks on your computer with no time limit. With nothing measured it is one sentence, not a table of dashes.
117
+ - The page check's help and messages say `genclass scan`, not `genclass-runtime scan`, the help says where the
118
+ check runs by default (on genclass.dev), and the full report's link is on genclass.dev.
119
+ - The npm page links to the command's guide, genclass.dev/docs/cli.
120
+
3
121
  ## 0.2.2
4
122
 
5
123
  From a walk through the whole setup as a new user, against a local copy of genclass.dev:
package/README.md CHANGED
@@ -1,6 +1,7 @@
1
1
  # genclass
2
2
 
3
- One command that sets GenClass up and tells you what your app needs next.
3
+ GenClass in your terminal: one command that sets it up, shows what it finds on your live site, has it fixed, and
4
+ answers questions about your app.
4
5
 
5
6
  ```bash
6
7
  npx genclass
@@ -10,41 +11,76 @@ Run it in your web app's folder. It shows where the project stands and walks you
10
11
  per step. Stop at any point and run it again: it continues from what is true now.
11
12
 
12
13
  ```text
13
- ██████╗ ███████╗███╗ ██╗ ██████╗██╗ █████╗ ███████╗███████╗
14
- ██╔════╝ ██╔════╝████╗ ██║██╔════╝██║ ██╔══██╗██╔════╝██╔════╝
15
- ██║ ███╗█████╗ ██╔██╗ ██║██║ ██║ ███████║███████╗███████╗
16
- ██║ ██║██╔══╝ ██║╚██╗██║██║ ██║ ██╔══██║╚════██║╚════██║
17
- ╚██████╔╝███████╗██║ ╚████║╚██████╗███████╗██║ ██║███████║███████║
18
- ╚═════╝ ╚══════╝╚═╝ ╚═══╝ ╚═════╝╚══════╝╚═╝ ╚═╝╚══════╝╚══════╝
14
+ ╭─ GenClass ────────────────────────────────────────────── v0.3.0 ─╮
15
+ │ │
16
+ │ Welcome back, Ada! │
17
+ │ │
18
+ │ ▄▄▄▄█▄ │
19
+ │ ▄█████████ │
20
+ │ ▄███▀▀ ▀▀ │
21
+ │ ███▀ ▄▄▄▄▄ │
22
+ │ ███▄ ▀█████ │
23
+ │ ▀███▄ ▄▄ ▄███▀ │
24
+ │ ▀▀▄████████▀ │
25
+ │ ▀▀█▀▀▀ │
26
+ │ │
27
+ │ shop • Vite + React │
28
+ │ ada@example.com • Free plan │
29
+ │ ~/code/shop │
30
+ │ │
31
+ ╰──────────────────────────────────────────────────────────────────╯
19
32
 
20
- Finds what breaks in your web app, and tells you what it needs next. v0.2.2
21
-
22
- GenClass • shop Vite + React
23
- ada@example.com • Free plan
24
- ────────────────────────────────────────────────────────────────────────────
25
33
  ✔ Done Account • Runtime
26
34
  ● Next Add the test workflow
27
35
  ◌ Waiting Dashboard: deploy, then open your site once
28
36
  ○ Later GitHub App • Coding agent • Suggestions
29
37
 
30
- Next Add the test workflow
31
- One new file, .github/workflows/genclass.yml. Your tests are not changed.
38
+ ▎ Next Add the test workflow
39
+ ▎ One new file, .github/workflows/genclass.yml.
32
40
 
33
- Enter to continue, d for every part, s to skip, q to stop
41
+ ────────────────────────────────────────────────────────────────────
42
+ ❯ Enter to continue · d every part · s skip · q later
34
43
  ```
35
44
 
36
- The view stays that short. Press `d` (or run `genclass status --all`) to see every part with what is known about
45
+ The view stays that short. Press `d` (or run `npx genclass status --all`) to see every part with what is known about
37
46
  it, and `d` again to fold it back.
38
47
 
48
+ ## It stays open
49
+
50
+ When the walk is done (or you press `q` to leave it for later), the command does not end. It asks what next:
51
+
52
+ ```text
53
+ What next? A command, or a question about your app.
54
+ dashboard what GenClass found on your live site
55
+ problems every problem, by kind and page
56
+ analytics visitors, pages, sources, clicks
57
+ events the latest events, one per line
58
+ fix hand a problem to your coding agent
59
+ ask ask about your app (or just type it)
60
+ connections alerts, GitHub, your coding agent
61
+ suggest what your app is missing
62
+ help every command q leave
63
+
64
+ ❯ which page loses the most visitors?
65
+ ```
66
+
67
+ Type a command, or a sentence: a sentence is a question about your app. `q` leaves. Everything here is also a
68
+ command of its own (`npx genclass problems`), so scripts and coding agents use the same things.
69
+
70
+ **Just `genclass`.** `npx` runs the command without installing it, so `genclass` alone is not a command yet. The
71
+ first time the home opens it offers to install it (`npm install -g genclass`, shown before it runs, asked once).
72
+ After that you type `genclass`, and every screen says `genclass` instead of `npx genclass`.
73
+
39
74
  ## Every part, in order
40
75
 
41
76
  | Part | What the step does | What it changes |
42
77
  |---|---|---|
43
78
  | Account | Opens genclass.dev in your browser; you approve a short code there. | A session file in your user config folder. Nothing is typed in the terminal. |
79
+ | Plan | On Free, shows the paid plan first: Enter opens its checkout in your browser, `f` goes on with Free for now. Asked once per project. | Nothing in your project. The payment is on Stripe's page; the command never sees a card. |
44
80
  | Runtime | Adds GenClass to the app: one import (or script tag) and the package. It watches the page in your users' browsers for lost edits, double submits and old data shown over new, and only reports, to the console and your dashboard. Nothing is drawn on your pages. | Your entry file and `package.json`; you see the change first. `genclass remove` undoes it. |
45
81
  | Dashboard | Waits for your live site to be opened once. GenClass sends nothing from localhost. | Nothing. |
46
82
  | Test workflow | Runs your Playwright tests once more per pull request with slow and reordered responses. | One new file, `.github/workflows/genclass.yml`, which you commit. |
47
- | GitHub App | Comments on a pull request when a page ends up wrong, with the steps to see it. The command opens GitHub's install page and waits for the answer. | Nothing in your project. The app cannot read or change your code. |
83
+ | GitHub App | Comments on a pull request when a page ends up wrong, with the steps to see it. The command opens GitHub's install page and waits for the answer. A repository that was renamed on GitHub is looked up under its new name. | Nothing in your project. The app cannot read or change your code. |
48
84
  | Coding agent | Gives Claude Code, Cursor and other agents GenClass's tools and its skill: ask what went wrong, replay it, check the fix. | `.mcp.json` (or `.cursor/mcp.json`) and `.claude/skills/genclass/SKILL.md`. |
49
85
  | Suggestions | Tells you what your app is missing, most important first. | Nothing in your project. |
50
86
 
@@ -83,13 +119,84 @@ suggestions run left to do.
83
119
  Visitors 312 visits · 1,020 page views · 41% left after one page
84
120
  Coding agent 5 found · 3 reproduced · 2 fixed · 1 with a test
85
121
  GitHub App reviewing · 4 pull requests so far
86
- Suggestions 7 to do, 2 urgent · checked 2 days ago · genclass suggest
122
+ Suggestions 7 to do, 2 urgent · checked 2 days ago · npx genclass suggest
123
+ ```
124
+
125
+ `--range 24h`, `7d` or `30d` (a plan with more history: `90d`, `1y`) picks the period, `--all` shows every row,
126
+ `--app <name>` another app of your account, `--open` the browser dashboard, `--json` the same as data. These are the
127
+ numbers your dashboard on genclass.dev shows, cut by the same plan rules.
128
+
129
+ Each part of the browser dashboard has its own view, short first, `--all` for every row:
130
+
131
+ | | |
132
+ |---|---|
133
+ | `npx genclass problems` | what was found, by kind and by page, the measured visual checks, what GenClass stopped on the visitor's screen, how it compares with the period before |
134
+ | `npx genclass analytics` | visitors: visits, page views, time on a page, where people come from, devices and countries, what gets clicked again and again. One part in full: `analytics pages`, `sources`, `devices`, `clicks`, `paths`, `funnels` (Team) |
135
+ | `npx genclass events` | the latest events one per line: when, kind, how sure the model was, the page, and what GenClass did |
136
+ | `npx genclass health` | how GenClass itself runs on your pages: model loads, where it ran, decision time, what was not checked, runtime versions |
137
+ | `npx genclass report` | the period as Markdown, to paste or pipe (`--out report.md` writes a file) |
138
+ | `npx genclass export` | every stored event as a file, JSON Lines or `--format csv`, `--from` and `--to` as days (Team) |
139
+
140
+ ## Have it fixed
141
+
142
+ ```bash
143
+ npx genclass fix
87
144
  ```
88
145
 
89
- `--range 24h`, `7d` or `30d` picks the period, `--all` shows every row, `--app <name>` another app of your account,
90
- `--open` the browser dashboard, `--json` the same as data. These are the numbers your dashboard on genclass.dev
91
- shows, cut by the same plan rules. The sign-in page says the command can show them; a sign-in from before 0.2.0
92
- was approved without that, so the command asks you to sign in once more.
146
+ It lists what GenClass found on your live site, you pick one (or Enter for all of them), and it starts your coding
147
+ agent in the project with a prompt: what was found, where, how it is usually fixed, and the steps that reproduce it
148
+ and prove the fix with GenClass's MCP server. Claude Code, Codex, Cursor's agent and Gemini CLI are started when
149
+ their command is installed; otherwise the prompt is copied (`c`) or printed (`p`).
150
+
151
+ GenClass changes no code. The agent does, in your own session with it, where you see and approve what it does.
152
+ Nothing starts without a key press. `npx genclass fix stale --print` prints the prompt for one kind and nothing
153
+ else, which is how an agent asks for it itself.
154
+
155
+ ## Ask
156
+
157
+ ```bash
158
+ npx genclass ask "what is going wrong on my site?"
159
+ ```
160
+
161
+ A question in your own words, answered by GenClass's model from what the runtime found on your live site: pages,
162
+ kinds of problem and counts, and with visitor analytics the sources and what people click. In the home, just type
163
+ the question; a follow-up ("and on which page?") carries the turn before it.
164
+
165
+ **What leaves your machine:** the question. The numbers are read on genclass.dev, where they already are, and go to
166
+ the model (OpenAI's API) with it. No code, no file of your project. Neither the question nor the answer is stored.
167
+ The command says this before the first question and waits for Enter. Ask and suggest share a plan's model runs a
168
+ day (3 on Free, 30 on Team).
169
+
170
+ ## Connections
171
+
172
+ ```bash
173
+ npx genclass connections
174
+ ```
175
+
176
+ Where your app's new problems are sent (Slack, Sentry, PostHog, Datadog, or a webhook of your own), what the GitHub
177
+ App is doing on the repository, whether your coding agent is connected, and whether the app has a private link.
178
+
179
+ - `npx genclass connections add slack` sets a destination up (Team). What you type is not shown, goes to
180
+ genclass.dev over HTTPS, is stored encrypted there and is not kept on your machine. Then `test`, `off`, `on`,
181
+ `remove` in place of `add`.
182
+ - `npx genclass agent` shows how your coding agent is connected and what it did with the findings (found,
183
+ reproduced, fix proven, closed). `npx genclass agent link` gives it the live site's numbers: it makes the app's
184
+ private dashboard link and hands it to GenClass's MCP server in your own agent settings, never in a file of the
185
+ repository.
186
+ - `npx genclass funnels add "Checkout" /cart /checkout /thanks` adds a funnel (Team); `funnels remove "Checkout"`
187
+ removes it.
188
+
189
+ ## Account
190
+
191
+ `npx genclass apps` lists your apps (`apps new "Name"` makes one). `npx genclass plan` shows your plan, its limits
192
+ and what is used; on Free it shows the paid plan and Enter opens its checkout. `npx genclass team` shows who is on
193
+ the plan (`team invite` makes a single-use invite link).
194
+
195
+ **What a terminal may do** is listed on the page where you approve its sign-in, and nothing else: read your apps'
196
+ dashboards, analytics and stored events, ask the model, change where alerts go, funnels and the private link, show
197
+ the plan and the team and make an invite link. It cannot change how you sign in, pay for anything, remove people,
198
+ or delete an app or your account: those stay in the browser, and the command prints the address. A sign-in from
199
+ before 0.3.0 was approved for less, so the first command that needs more asks you to sign in once more.
93
200
 
94
201
  ## Suggestions
95
202
 
@@ -122,18 +229,33 @@ prompt) is shown for the first three items on Free and for all of them on Team,
122
229
 
123
230
  ## Commands
124
231
 
232
+ `npx` runs the command without installing it. To type just `genclass`, install it once: `npm install -g genclass`
233
+ (the command offers to, the first time its home opens).
234
+
125
235
  | | |
126
236
  |---|---|
127
- | `genclass` | where the project stands; on a terminal, the next step |
128
- | `genclass setup` | the guided setup (`--yes`: no questions) |
129
- | `genclass status` | what is done and what is next (`--all`: every part; `--json`) |
130
- | `genclass suggest [url]` | what your app is missing (`--json`, `--yes`, `--no-model`, `--all`) |
131
- | `genclass dashboard` | your app in the terminal (`--range`, `--all`, `--app`, `--open`, `--json`) |
132
- | `genclass scan <url>` | 23 visual checks on one page |
133
- | `genclass login`, `logout`, `whoami` | your account |
134
- | `genclass remove` | take GenClass out of the app again |
135
-
136
- Options everywhere: `--cwd <dir>`, `--yes`, `--json`, `--no-browser`.
237
+ | `npx genclass` | where the project stands; on a terminal, the next step, then the home |
238
+ | `npx genclass setup` | the guided setup (`--yes`: no questions) |
239
+ | `npx genclass status` | what is done and what is next (`--all`: every part; `--json`) |
240
+ | `npx genclass dashboard` | your app in the terminal (`--open` the browser dashboard) |
241
+ | `npx genclass problems` | every problem found, by kind and page, and what GenClass did |
242
+ | `npx genclass analytics [part]` | visitors; parts: `pages`, `sources`, `devices`, `clicks`, `paths`, `funnels` |
243
+ | `npx genclass events` | the latest events, one per line |
244
+ | `npx genclass health` | how GenClass itself runs on your pages |
245
+ | `npx genclass report` | the period as Markdown (`--out <file>`) |
246
+ | `npx genclass export` | every stored event as a file (`--from`, `--to`, `--format csv`, `--out`) |
247
+ | `npx genclass fix [number, kind or all]` | hand a problem to your coding agent (`--print`, `--copy`, `--agent <name>`) |
248
+ | `npx genclass ask "..."` | a question about your app, answered from its numbers |
249
+ | `npx genclass suggest [url]` | what your app is missing (`--yes`, `--no-model`, `--all`) |
250
+ | `npx genclass scan <url>` | 23 visual checks on one page |
251
+ | `npx genclass connections` | alerts, GitHub App, coding agent (`add`, `test`, `on`, `off`, `remove` a destination) |
252
+ | `npx genclass agent` | your coding agent and what it did (`agent link`) |
253
+ | `npx genclass funnels` | funnels (`add "Name" /a /b`, `remove "Name"`) |
254
+ | `npx genclass apps`, `plan`, `team` | your apps, your plan, the people on it |
255
+ | `npx genclass login`, `logout`, `whoami` | your account |
256
+ | `npx genclass remove` | take GenClass out of the app again |
257
+
258
+ Options: `--app <name>`, `--range 24h|7d|30d|90d|1y`, `--all`, `--json`, `--cwd <dir>`, `--yes`, `--no-browser`.
137
259
 
138
260
  ## For coding agents
139
261
 
@@ -144,6 +266,9 @@ npx genclass status --json # where things stand, and "next": the command to
144
266
  npx genclass setup --yes # does every step that needs no person; prints the links for the ones that do
145
267
  npx genclass suggest --json # the checks that failed, with evidence, in order
146
268
  npx genclass dashboard --json # what GenClass found on the live site
269
+ npx genclass problems --json # the same by kind and page; also analytics, events, health, agent
270
+ npx genclass fix --print # the prompt to fix what was found (fix stale --print: one kind)
271
+ npx genclass report # the period as Markdown
147
272
  ```
148
273
 
149
274
  Two steps need the person: approving the sign-in and installing the GitHub App. Both happen in their browser, and