Three ways in. Pick one.

The first two need Node.js 20 or later and nothing installed first. Your free account is made at the sign-in, with GitHub, Google or an email.

What you will see

Where your project stands, and the next step. Press Enter to do it. Stop any time and run it again: it continues from where things are. Nothing waits on you: Enter also skips a wait.

  ╭─ GenClass ───────────────────────────────────────────╮
  │                                                      │
  │                  Welcome back, Ada!                  │
  │                                                      │
  │                        ▄▄▄▄█▄                        │
  │                     ▄█████████                       │
  │                   ▄███▀▀  ▀▀                         │
  │                   ███▀     ▄▄▄▄▄                     │
  │                   ███▄     ▀█████                    │
  │                   ▀███▄ ▄▄  ▄███▀                    │
  │                     ▀▀▄████████▀                     │
  │                        ▀▀█▀▀▀                        │
  │                                                      │
  │                 shop • Vite + React                  │
  │             [email protected] • Free plan              │
  │                     ~/code/shop                      │
  │                                                      │
  ╰──────────────────────────────────────────────────────╯

  ✔  Done     Account • Runtime
  ●  Next     Add the test workflow
  ◌  Waiting  Dashboard: deploy, then open your site once
  ○  Later    GitHub App • Coding agent • Suggestions

  ▎ Next  Add the test workflow
  ▎ One new file, .github/workflows/genclass.yml.

  ────────────────────────────────────────────────────────
  ❯ Enter to continue · d every part · s skip · q later

That is the whole screen. d shows every part and folds it back.

It stays open

When the setup is done, or you press q to leave it for later, the command asks what next. Type a command, or a question about your app. q leaves.

  What next? A command, or a question about your app.
    dashboard    what GenClass found on your live site
    problems     every problem, by kind and page
    analytics    visitors, pages, sources, clicks
    events       the latest events, one per line
    fix          hand a problem to your coding agent
    ask          ask about your app (or just type it)
    connections  alerts, GitHub, your coding agent
    suggest      what your app is missing
    help         every command   q leave

  ❯ which page loses the most visitors?

The first time, it offers to install itself so you can type just genclass. It shows the line it runs (npm install -g genclass) and asks once.

What it sets up

Eight parts, in order. A part that does not fit your project is skipped and says why.

Part	What happens
Account	Your browser opens. You approve a short code. Nothing is typed in the terminal.
Plan	On Free, the paid plan is shown first. Enter opens its checkout in your browser. f goes on with Free for now.
Runtime	One import and the package are added to your app. You see the change first. Nothing is drawn on your pages.
Dashboard	Fills once your live site has been opened. Nothing is sent from localhost.
Test workflow	One new file runs your Playwright tests once more on each pull request, with slow and reordered responses.
GitHub App	GitHub opens for the install. The app comments on a pull request when a page ends up wrong. It cannot read your code.
Coding agent	Adds GenClass's tools and its skill to Claude Code, Cursor and other agents (.mcp.json, .claude/skills/genclass).
Suggestions	Checks your repository and your live site, and tells you what to do first.

Let your coding agent do it

Paste this into Claude Code, Codex or Cursor. The agent runs the command for you and stops only for the two things that need you: approving the sign-in and installing the GitHub App.

The command asks nothing when an agent runs it:

npx genclass status --json     # where things stand, and what to run next
npx genclass setup --yes       # does every step that needs no person
npx genclass suggest --json    # what the app is missing, in order
npx genclass dashboard --json  # what GenClass found on the live site
npx genclass problems --json   # the same by kind and page
npx genclass fix --print       # the prompt to fix what was found

Your app in the terminal

npx genclass dashboard

What GenClass found on your live site, in one screen: problems by kind and page, visual checks, visitors, what your coding agent fixed, and what the GitHub App is doing.

  last 7 days · last page 3 hours ago

  Visits watched 1,204      Problems found 17         ▁▃▂▇▅▁█
  Handled        3          Visual checks  9

  Problems
    12  duplicate  /checkout    the same request went out twice
     4  stale      /orders/:id  old data replaced newer data
     1  failing    /cart        a request keeps failing

  Visitors       312 visits · 1,020 page views
  Coding agent   5 found · 3 reproduced · 2 fixed · 1 with a test
  GitHub App     reviewing · 4 pull requests so far

--range 24h, 7d or 30d picks the period. --all shows every row. --open opens the browser dashboard. Visitor analytics come with Team.

Every part of the dashboard

Each part of the browser dashboard has its own command. Short first, --all for every row, --json for data.

npx genclass problems	What was found, by kind and by page, and what GenClass stopped on the visitor's screen.
npx genclass analytics	Visitors: visits, pages, time on a page, sources, devices, clicks. One part in full: analytics pages, sources, devices, clicks, paths, funnels. Comes with Team.
npx genclass events	The latest events, one per line: when, what kind, how sure, which page.
npx genclass health	How GenClass itself runs on your pages.
npx genclass report	The period as Markdown. --out report.md writes a file.
npx genclass export	Every stored event as a file, JSON Lines or CSV. Comes with Team.

Have it fixed

npx genclass fix

It lists what GenClass found. Pick one, or Enter for all. It starts your coding agent in the project with a prompt: what was found, where, how it is usually fixed, and the steps that reproduce it and prove the fix. Claude Code, Codex, Cursor's agent and Gemini CLI are started when installed. Otherwise the prompt is copied or printed.

GenClass changes no code. Your agent does, in your own session with it. Nothing starts without a key press.

Ask

npx genclass ask "what is going wrong on my site?"

A question in your own words, answered from what GenClass found on your live site. A follow-up remembers the question before it.

Only your question leaves your machine. The app's numbers are already on genclass.dev and go to the model with it. No code. Nothing is stored. Ask and suggest share your plan's answers a day: 3 on Free, 30 on Team.

Connections

npx genclass connections

Where your app's new problems are sent, what the GitHub App is doing, and whether your coding agent is connected.

npx genclass connections add slack	Sends each new problem to Slack. Also sentry, posthog, datadog, webhook. What you type is not shown. Then test, off, on, remove. Comes with Team.
npx genclass agent	How your coding agent is connected and what it did with the findings.
npx genclass agent link	Gives your agent the live site's numbers. The link goes into your own agent settings, not into the repository.
npx genclass funnels	Funnels. funnels add "Checkout" /cart /checkout /thanks adds one.

Suggestions

npx genclass suggest https://your-site.com

It measures your repository and your live site and lists what is missing, most important first: search and link previews, whether AI assistants can read the site, test payment keys on the live site, secrets in the repository, tests, email records. Each item comes with what was measured, what to do, and a prompt for your coding agent.

Every check is free. The plan written for your app shows its first three items on Free and all of them on Team.

Commands

npx runs the command without installing it. To type just genclass, install it once: npm install -g genclass. The command offers to.

npx genclass	Where the project stands, the next step, then the prompt that stays open.
npx genclass status	The same, without doing anything. --all shows every part.
npx genclass dashboard	Your app in the terminal.
npx genclass problems, analytics, events, health	Each part of the dashboard, in full.
npx genclass report, export	The period as Markdown, and every stored event as a file.
npx genclass fix	Hands a problem to your coding agent.
npx genclass ask "..."	A question about your app, answered from its numbers.
npx genclass connections, agent, funnels	Alerts, your coding agent, funnels.
npx genclass apps, plan, team	Your apps, your plan, the people on it.
npx genclass suggest [url]	What your app is missing.
npx genclass scan <url>	23 visual checks on one page.
npx genclass login, logout, whoami	Your account.
npx genclass remove	Takes GenClass out of the app again.

Everywhere: --app <name>, --range 24h|7d|30d, --all, --json, --cwd <dir>, --yes, --no-browser.

What it reads and sends

The command reads your project's files on your machine. They stay there. It talks to genclass.dev with your sign-in, to list your apps and show your dashboard.

What a terminal may do is listed on the page where you approve its sign-in. It cannot change how you sign in, pay for anything, remove people, or delete an app or your account. Those stay in the browser.

genclass ask sends your question. genclass.dev adds your app's dashboard numbers and passes both to the model (OpenAI). No code. Neither the question nor the answer is stored. The command says this before your first question.

genclass suggest sends requests to your own site, and a short digest to genclass.dev: the checks that failed with what was measured, plus your app's name, framework, address, payment provider and host. No source code, no file contents, no secrets. It shows the digest before the first send, and --no-model sends nothing. Details: PRIVACY.md.

Remove it

npx genclass remove

Undoes what the setup added to your app. The command is open source (Apache-2.0): packages/cli, on npm as genclass.