# Start

ra opens your web app in Chromium, inside a fake world you describe, and tells your coding agent in sentences what a person would find wrong: text cut off, a button that something else covers, grey text too pale to read, or a page that scrolls sideways on a phone. It is UI testing for agents, made to run in the middle of a change.

ra needs Node 22.18 or later, on macOS or Linux. Install it from its GitHub release, then look at a page of your running app:

```sh
npm install -D https://github.com/hraness/ra/releases/download/v0.1.6/hraness-ra-0.1.6.tgz playwright-core
npx playwright-core install chromium
npx ra look http://127.0.0.1:3000/ --at phone
```

If your project already has `playwright` or `@playwright/test`, leave `playwright-core` out and install the browser with `npx playwright install chromium`.

That first look needs no config. It prints the findings, an outline of the page, a sketch of its layout, and where it saved two pictures. To check every screen of your app in one run, [name its states](https://hraness.github.io/ra/docs/setting-up/) and run `ra check`. To have your coding agent run ra by itself, give it [the skill](https://hraness.github.io/ra/docs/for-coding-agents/).
