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

# Quick Start

> Connect your first repository and trigger your first automated review in minutes.

Ito integrates with GitHub via a native app and starts testing your pull requests automatically. No test scripts to write — you just connect a repo and open a PR.

<Note>
  Ito offers a free trial. No credit card is required to get started.
</Note>

## Before you begin

You'll need:

* A GitHub account (organization or personal)
* At least one repository with open or recent pull requests
* A deployed or locally accessible version of your app that Ito can browse

<Steps>
  <Step title="Sign up">
    Go to [app.ito.ai](https://app.ito.ai) and click **Sign up with GitHub**.

    Ito uses GitHub OAuth — no separate password required. After authenticating, you'll land on the onboarding wizard at `/auth/setup`.

    <Note>
      GitLab support is coming soon. For now, GitHub OAuth is the only sign-in method.
    </Note>
  </Step>

  <Step title="Install the GitHub App">
    In the **Connect** step of the onboarding wizard, you'll see a list of GitHub installations available to your account.

    * If you've already installed the Ito GitHub App on an organization or personal account, select it from the list.
    * If not, click **Install App** to open GitHub's app installation page. Choose the organization or personal account where you want Ito to run, and grant access to the repositories you want tested.

    Once you've selected an installation, click **Continue**.

    <Tip>
      You can install Ito on multiple organizations. Use the account switcher in the dashboard to move between them.
    </Tip>

    <Note>
      **Not an organization owner?** If you don't have permission to install GitHub Apps on your organization, GitHub queues an access request and Ito shows a **Waiting on organization owner approval** screen. Your owner is notified automatically — once they approve, return to this page to finish setup. You can also click **Resend request** to re-notify them.
    </Note>
  </Step>

  <Step title="Select a repository and trigger a first review">
    In the **Review** step, select a repository from the dropdown. Ito will load your open pull requests from that repo.

    Pick a pull request to trigger your first automated review, then click **Continue**.

    If you don't have an open PR ready, click **Skip for now** — Ito will automatically test the next PR you open.

    <Note>
      Ito filters the PR list to requests authored by you. Make sure the selected repository has PRs you've opened, or manage repository access via **Manage Repositories**.
    </Note>
  </Step>

  <Step title="Start your free trial">
    The **Ready** step confirms your free trial has started. Click **Go to dashboard** to open the Ito dashboard.

    From this point on, Ito runs automatically on every new or updated pull request in the connected repository.
  </Step>

  <Step title="Open a pull request">
    Open or update any pull request in a connected repository. Ito receives the webhook from GitHub, provisions a test environment, and starts the automated run.

    While the run is in progress, the dashboard shows a **Running...** status next to the PR. Results update automatically — no need to refresh.
  </Step>

  <Step title="View the results">
    Once the run completes, results appear in two places:

    **In GitHub:** Ito posts a comment directly on the pull request with bug reports, reproduction steps, and video evidence.

    **In the dashboard:** Open the PR from the dashboard to see all test cases, a video recording of the session, reproduction steps, and code analysis with relevant file references.

    <Tip>
      The dashboard shows passed and failed test cases side by side. Click any test case to see the video seek to the exact moment the issue occurred.
    </Tip>
  </Step>
</Steps>

## What's next

<CardGroup cols={2}>
  <Card title="Connect a repository" icon="code-branch" href="/guides/connect-repository">
    Manage which repositories Ito monitors and adjust access permissions.
  </Card>

  <Card title="Reading results" icon="magnifying-glass" href="/guides/reading-results">
    Understand test cases, severity levels, video recordings, and code analysis.
  </Card>

  <Card title="Testing level" icon="sliders" href="/settings/testing-level">
    Control how many tests Ito runs per PR — from 5 to 20 tests per run.
  </Card>

  <Card title="How Ito works" icon="gears" href="/how-it-works">
    Learn what happens between a PR being opened and a bug report being posted.
  </Card>
</CardGroup>