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.
- package/CHANGELOG.md +118 -0
- package/README.md +157 -32
- package/dist/genclass.mjs +6289 -3278
- 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
|
-
|
|
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
|
-
|
|
38
|
+
▎ Next Add the test workflow
|
|
39
|
+
▎ One new file, .github/workflows/genclass.yml.
|
|
32
40
|
|
|
33
|
-
|
|
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
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
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
|
|
131
|
-
| `genclass
|
|
132
|
-
| `genclass
|
|
133
|
-
| `genclass
|
|
134
|
-
| `genclass
|
|
135
|
-
|
|
136
|
-
|
|
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
|