Skip to main content
This walks you through your first Percio test using the web app. If you’d rather test localhost or wire Percio into Cursor, jump to the Agent overview.

​
1. Create an account

Head to percio.app and sign up with email or Google. Email sign-ups are confirmed via a link sent to your inbox — click it to finish creating your account. If you’re picking the Indie plan, you’ll start a 14-day trial (credit card required). Pro has no trial. See Plans for the full comparison.

​
2. Create your first persona

On first sign-in, Percio opens an onboarding wizard that generates a persona tailored to the product you’re building. Answer a few questions about your users and you’ll end up with a persona ready to run tests against. You can create more personas later on the Personas page. See Creating personas for the field-by-field walkthrough.

​
3. Start a test

Go to Tests and paste the URL you want to test. Percio will:
  1. Fetch context from the page so it knows what it’s looking at.
  2. Ask a few quick questions about what you want to test — what the user should try to do, what success looks like, any constraints.
  3. Generate a scenario from that conversation.
  4. Let you pick a persona to run the test through.
When you hit Run Test, Percio launches a real browser on our servers and starts working.
The quality of your scenario drives the quality of your report. See Writing good scenarios for the one-page guide that pays for itself.

​
4. Watch the test run

You’ll be taken to the live execution page. While the test runs, you can watch:
  • The progress ring showing how far along the agent thinks it is.
  • The step timeline — each action the browser takes (click, type, scroll, navigate, wait).
  • The AI reasoning panel — what the agent is thinking before each action, so you can see why it made every move.
Most tests finish in 1–3 minutes depending on the flow.

​
5. Read your report

When the run finishes, Percio drops you on the results page. You’ll see:
  • A usability score from 0–100.
  • An executive summary with the biggest risk, drop-off patterns, and quick wins.
  • Issues, each with severity, the Nielsen heuristic it violates, and a four-part breakdown: What’s happening, Why it matters, Who it affects most, Recommendation.
  • Positive notes — things the persona liked.
  • A flow timeline with every step the browser took, screenshot by screenshot.
For each issue, you can mark it Confirmed, False positive, or Dismissed to keep your findings clean.

​
What’s next

Write better scenarios

The single biggest lever for test quality.

Pick the right persona

Which persona to use for a test and what makes a persona signal-rich.

Read results deeply

The full anatomy of the results page.

Test localhost

Install the CLI and test unshipped work before it goes live.