Three ways in. Pick one.

1In your terminal

Run one command in your app's folder and press Enter a few times. About three minutes.

2With your coding agent

Paste one prompt into Claude Code, Cursor or Codex. It runs the command for you.

3Without a terminal

A plain HTML site? Paste one script tag first in <head>. Nothing to run.

The script tag →

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 • shop                                    Vite + React
  ada@example.com • Free plan
  ────────────────────────────────────────────────────────────────
  ✔  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 for every part, s to skip, q to stop

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

What it sets up

Seven 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.
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

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.

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

`genclass`	Where the project stands, and the next step.
`genclass status`	The same, without doing anything. `--all` shows every part.
`genclass dashboard`	Your app in the terminal.
`genclass suggest [url]`	What your app is missing.
`genclass scan <url>`	23 visual checks on one page.
`genclass login`, `logout`, `whoami`	Your account.
`genclass remove`	Takes GenClass out of the app again.

Everywhere: --cwd <dir>, --yes, --json, --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.

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.

npx genclass: one command sets up GenClass.