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

# Quickstart

> Paste your app URL. Perfai does the rest — autonomous security testing in about 20 minutes.

## All you need is a URL

No code access. No configuration. No browser plugins. Paste your app URL and Perfai's agents handle everything — account creation, role discovery, app mapping, and security testing — completely on their own.

<Frame>
  <img className="docs-frame-img" src="https://mintcdn.com/perfai/K_J1iZD0uiJWM7ct/docs/images/qs-01-new-app.png?fit=max&auto=format&n=K_J1iZD0uiJWM7ct&q=85&s=30a21926b878c5c4eb5a15c94aa602fe" alt="Perfai — Test a new app" width="1920" height="945" data-path="docs/images/qs-01-new-app.png" />
</Frame>

Hit the arrow button and three agents run in sequence:

<CardGroup cols={3}>
  <Card title="01 — Vision Agent" icon="eye">
    Maps every workflow, API, role & data in minutes.
  </Card>

  <Card title="02 — Security Agent" icon="shield-halved">
    Runs thousands of custom security tests across roles & tenants.
  </Card>

  <Card title="03 — Fix Agent" icon="wand-magic-sparkles">
    Generates & verifies precise fixes via Cursor, Claude & Replit.
  </Card>
</CardGroup>

***

## What happens step by step

<Steps>
  <Step title="Confirm and start">
    After you paste your URL, Perfai shows a **New app setup** confirmation with the four tasks it will run automatically:

    <Frame>
      <img className="docs-frame-img" src="https://mintcdn.com/perfai/K_J1iZD0uiJWM7ct/docs/images/qs-02-setup-modal.png?fit=max&auto=format&n=K_J1iZD0uiJWM7ct&q=85&s=bde088a813998efc6ae68d531124ed6d" alt="New app setup — task confirmation modal" width="1920" height="945" data-path="docs/images/qs-02-setup-modal.png" />
    </Frame>

    | # | Task                    | Type       |
    | - | ----------------------- | ---------- |
    | 1 | Create Test Accounts    | One-time   |
    | 2 | Discover & Create Roles | One-time   |
    | 3 | App Mapping             | Continuous |
    | 4 | Security Testing        | Continuous |

    Click **Continue**. You don't need to configure anything else.

    <Note>
      **One-time** tasks run once to bootstrap your test environment. **Continuous** tasks re-run automatically on every future scheduled scan as your app evolves.
    </Note>
  </Step>

  <Step title="Vision Agent builds the task graph">
    The **Vision** tab opens showing the full agent execution plan. Each node in the graph is a task the Vision Agent will complete — in order — before handing off to the Security Agent.

    <Frame>
      <img className="docs-frame-img" src="https://mintcdn.com/perfai/K_J1iZD0uiJWM7ct/docs/images/qs-03-vision-init.png?fit=max&auto=format&n=K_J1iZD0uiJWM7ct&q=85&s=b73001c9789a5d8603d8e2d70f3fad99" alt="Vision Agent task graph — account creation and role discovery" width="1920" height="945" data-path="docs/images/qs-03-vision-init.png" />
    </Frame>

    The right panel renders the live task graph:

    ```
    Vision Agent
        ├──▶ Account creation       ──▶ Account verification
        ├──▶ RBAC Account Creation  ──▶ RBAC Account Verification
        ├──▶ Attack surface mapping
        └──▶ Security Testing
    ```

    The left panel logs every action in real time:

    ```
    Creating Account 1...
    Waiting for task to be picked up by Vision...
    Starting: Creating Account 1...
    ```

    The agent asks one question first: would you like it to auto-sign up accounts using your app URL? Answer **Yes** for fully automated account creation, provide credentials manually, or skip and add them later. **Yes** is the right answer for most apps.
  </Step>

  <Step title="Vision Agent maps your entire application">
    With test accounts created and roles confirmed, the Vision Agent takes control of a cloud browser and explores your entire app — clicking through every screen, submitting forms, and recording every API call made along the way.

    <Frame>
      <img className="docs-frame-img" src="https://mintcdn.com/perfai/K_J1iZD0uiJWM7ct/docs/images/qs-06-app-mapping.png?fit=max&auto=format&n=K_J1iZD0uiJWM7ct&q=85&s=80abac18af101846466b2b3e64bcb2aa" alt="Vision Agent mapping the application — live browser stream" width="1917" height="943" data-path="docs/images/qs-06-app-mapping.png" />
    </Frame>

    Watch the live browser stream as it autonomously navigates your app in real time. The left panel tracks every step:

    ```
    App mapping has started. This process may take up to 10 minutes.
    Step 3: Attack Surface Mapping
    → Enter a phone number in the Phone field and click Save...
    ```

    The result is a complete attack surface map — every UI workflow, API endpoint, role permission, and sensitive data type documented automatically.
  </Step>

  <Step title="Security Agent runs and results appear">
    When mapping completes, the Security Agent immediately begins running permission tests across all discovered endpoints. No trigger needed.

    ```
    Analyzing Attack Surface Map
    Triggering security test runs...
    Your app is now being tested. Security runs have been triggered.
    ```

    When done, switch to the **Overview** tab to see your full results:

    <Frame>
      <img className="docs-frame-img" src="https://mintcdn.com/perfai/K_J1iZD0uiJWM7ct/docs/images/qs-08-overview.png?fit=max&auto=format&n=K_J1iZD0uiJWM7ct&q=85&s=fdd45f8a0316d9d45a3bb49af5905c46" alt="Perfai Overview — security results dashboard" width="1920" height="945" data-path="docs/images/qs-08-overview.png" />
    </Frame>

    **Security Risk** shows confirmed findings:

    |                        |    |                                              |
    | ---------------------- | -- | -------------------------------------------- |
    | 🔴 **Critical / High** | 15 | Immediate action required                    |
    | 🟡 **Medium / Low**    | 2  | Standard priority issues                     |
    | 🟢 **Fixed**           | 0  | Issues resolved (grows as you fix & re-scan) |

    **Attack Surface** shows what was covered:

    |                |                      |
    | -------------- | -------------------- |
    | Workflows      | 24 UI flows mapped   |
    | Endpoints      | 13 APIs discovered   |
    | Roles          | 1 user role tested   |
    | Sensitive data | 7 data types exposed |
    | Security tests | 703 test cases run   |

    Click any finding to see the affected endpoint, attacking role, expected vs. actual response, and a reproduction step you can run immediately. Click **Actions → Generate Reports** to export your full security report.
  </Step>

  <Step title="Drill into the Security tab for detailed findings">
    Switch from **Overview** to the **Security** tab for the full issues list — every confirmed vulnerability for this specific app, sorted by severity.

    <Frame>
      <img className="docs-frame-img" src="https://mintcdn.com/perfai/K_J1iZD0uiJWM7ct/docs/images/qs-09-security-tab.png?fit=max&auto=format&n=K_J1iZD0uiJWM7ct&q=85&s=7e072b872529f6df39fafd3f1f09cfb5" alt="Perfai Security tab — per-app issues list with CVSS scores and savings" width="1920" height="945" data-path="docs/images/qs-09-security-tab.png" />
    </Frame>

    The three headline cards summarize your exposure for this app:

    |                           |                                                      |
    | ------------------------- | ---------------------------------------------------- |
    | 🔴 **Critical / High**    | 49 — immediate action required                       |
    | 🟡 **Medium / Low**       | 17 — standard priority                               |
    | 💚 **Bug Bounty Savings** | \$240K — potential costs avoided if found externally |

    The issues table shows **66 total findings** with full detail per row:

    | Column            | What it means                                                                                                                               |
    | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Issue**         | Vulnerability name, affected role, and the specific action being exploited (e.g., *BOLA – Cross-Tenant Access for role Ui-Auth-T2 - Admin*) |
    | **Security Risk** | The OWASP API standard the issue maps to (e.g., `OWASP API1:2023`)                                                                          |
    | **CVSS**          | Severity score 0–10. All BOLA findings here score 9.8 — maximum urgency                                                                     |
    | **CWE ID**        | Common Weakness Enumeration ID for precise categorization (e.g., `CWE-20`)                                                                  |
    | **Savings**       | Estimated bug bounty value if a researcher had found this instead (e.g., `$5,000` per finding)                                              |
    | **Severity**      | Critical / High / Medium / Low badge                                                                                                        |
    | **Since / Last**  | When the issue was first found and most recently confirmed                                                                                  |

    Use the **All Runs / Coverage / AI Logs / Last Run / Errors** tabs to dig deeper into test coverage, the agent's reasoning, and any test execution errors.

    <Note>
      The Security tab is scoped to one app. The global [Issues](/docs/core-concepts/issues) page aggregates findings across your entire portfolio — useful for org-wide risk reviews and compliance reporting.
    </Note>
  </Step>
</Steps>

***

## Runs automatically from here

Once registered, Perfai keeps testing your app on a continuous schedule — visible at the top of every app dashboard (`Next: Nightly`). No manual trigger needed.

| Task             | Frequency                                 |
| ---------------- | ----------------------------------------- |
| App mapping      | Continuous — re-maps as your app changes  |
| Security testing | Continuous — re-tests the updated surface |
| Full scan        | Nightly by default                        |

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Core Concepts" icon="book" href="/docs/core-concepts/apps">
    Understand how Perfai models apps, workflows, roles, and issues.
  </Card>

  <Card title="Understanding Issues" icon="bug" href="/docs/core-concepts/issues">
    Learn how findings are classified, prioritized, and tracked to resolution.
  </Card>
</CardGroup>
