> ## Documentation Index
> Fetch the complete documentation index at: https://docs.percio.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> AI-powered usability testing for any website or app

## What is Percio

Percio is an AI-powered usability testing platform. You point it at a URL, describe what a user would try to do, and pick a persona — Percio launches a real browser, navigates the site as that persona would, and returns a usability report grounded in Nielsen heuristics.

A run gives you a usability score, an executive summary, issues with severity and recommendations, quick wins, biggest risks, drop-off patterns, and a full flow timeline of every step Percio took.

## Two ways to run Percio

<Columns cols={2}>
  <Card title="The web app" icon="browser" href="/quickstart">
    Paste a URL, answer a short conversation, watch the test run live, read the report. The fastest way to get started.
  </Card>

  <Card title="The agent (CLI & MCP)" icon="terminal" href="/agent/overview">
    Run tests against `localhost` from your terminal, or drive Percio from Cursor via MCP while you code.
  </Card>
</Columns>

## Start here

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Sign up and run your first test in under 5 minutes.
  </Card>

  <Card title="Core concepts" icon="book" href="/core-concepts">
    The vocabulary you'll see everywhere: test, scenario, persona, credit, execution.
  </Card>

  <Card title="Writing good scenarios" icon="pen-fancy" href="/tests/writing-scenarios">
    Scenario quality is the single biggest lever for test quality. Start here.
  </Card>

  <Card title="Agent overview" icon="bolt" href="/agent/overview">
    Install the CLI, authenticate, and run tests against `localhost`.
  </Card>
</Columns>

## How a test works

1. **You describe what to test.** A URL, a scenario (e.g. "Sign up for an account"), and a persona.
2. **Percio launches a real browser.** Playwright drives Chromium end-to-end, exactly as a user would.
3. **The agent navigates as your persona.** Each step: screenshot, decide, act. It can click, type, scroll, select, wait, and navigate.
4. **The persona evaluates the recorded flow.** Claude reviews every step through the persona's lens and surfaces issues tied to Nielsen heuristics.
5. **You get a report.** Usability score, executive summary, issues grouped by severity, and a step-by-step flow timeline.

## What's next

* Run your first test → [Quickstart](/quickstart)
* Understand the pieces → [Core concepts](/core-concepts)
* Test `localhost` from your terminal → [Agent: install](/agent/install)