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

# Reviews

> View review history, filter by status or severity, and inspect individual findings.

The Reviews page shows every pull request review MergeWatch has processed. Use it to audit findings, track review performance, and drill into individual results.

## Stats strip

Four metrics are displayed above the table:

| Metric                  | Description                                                                              |
| ----------------------- | ---------------------------------------------------------------------------------------- |
| **Total reviews**       | Number of PRs reviewed across all repos in the installation                              |
| **Average review time** | Mean wall-clock time from webhook receipt to comment posted                              |
| **Issues caught**       | Count of findings rated critical or high severity                                        |
| **Skip rate**           | Percentage of PRs that were skipped (exceeded `maxFiles`, matched ignore patterns, etc.) |

## Filter bar

The filter bar supports the following controls:

* **Search** — filter by PR title, PR number, or author username
* **Repo** — dropdown scoped to repos in the current installation
* **Status** — `All`, `Reviewed`, `Skipped`, `Failed`, `Reviewing...`
* **Severity** — filter to reviews containing findings at a specific severity level
* **Date range** — date picker for start and end dates

<Tip>
  Filters are reflected in the URL query string. Bookmark a filtered view or share it with a teammate.
</Tip>

## Table columns

| Column       | Details                                                     |
| ------------ | ----------------------------------------------------------- |
| **PR**       | PR number, title, and base/head branch pills                |
| **Repo**     | Repository name                                             |
| **Author**   | GitHub avatar and username                                  |
| **Findings** | Severity badge with count (e.g., `2 critical`, `5 warning`) |
| **Status**   | Badge — `Reviewed`, `Skipped`, `Failed`, or `Reviewing...`  |
| **Date**     | Relative timestamp (e.g., "3 hours ago")                    |

Click any column header to sort. The table displays 25 rows per page with pagination controls at the bottom.

## Detail drawer

Click any row to open a 480px right-side panel with the full review details.

<AccordionGroup>
  <Accordion title="PR Summary">
    The high-level summary generated by the summary agent, including the 1–5 merge readiness score and a plain-language description of the changes.
  </Accordion>

  <Accordion title="Issues Found">
    All findings ranked by severity. Each finding includes the file path and line number, linking directly to GitHub. Critical and high findings are listed first.
  </Accordion>

  <Accordion title="Architecture Diagram">
    A Mermaid diagram showing the architectural impact of the changes. Rendered inline in the drawer.
  </Accordion>

  <Accordion title="Review Stats">
    Timing breakdown (total wall-clock, per-agent duration), agent invocation details, and token usage (input/output tokens per agent).
  </Accordion>

  <Accordion title="Feedback">
    Thumbs up / thumbs down buttons. Feedback is stored and used to improve review quality over time.
  </Accordion>
</AccordionGroup>

**Keyboard shortcuts:**

| Key      | Action                          |
| -------- | ------------------------------- |
| `Escape` | Close the drawer                |
| `J`      | Navigate to the next review     |
| `K`      | Navigate to the previous review |

## Linking to GitHub

Every finding in the detail drawer links to the exact file and line on GitHub. Click the file path to open the file at the correct line in a new tab. The PR title at the top of the drawer links to the pull request on GitHub.

## Empty states

<Note>
  If no reviews exist yet, the page displays a prompt linking to the [Repositories](/dashboard/repositories) page so you can verify your repos are connected and active.
</Note>

If filters return no results, a **Clear filters** button resets all filters and reloads the full review list.