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

# Viewing Run History

> Browse past runs and their reports via the CLI or the dashboard.

## CLI — `qaos hist`

The `qaos hist` command displays a summary table of your recent runs directly in the terminal.

```bash theme={null}
qaos hist
```

### Options

| Flag             | Alias | Description                                             |
| ---------------- | ----- | ------------------------------------------------------- |
| `--limit <n>`    | `-l`  | Number of recent runs to display (default: 10, max: 50) |
| `--project <id>` | `-p`  | Filter results to a specific project ID                 |

### Examples

```bash theme={null}
# Show last 10 runs across all projects
qaos hist

# Show last 5 runs
qaos hist -l 5

# Show runs for a specific project
qaos hist -p <project-id>

# Show last 20 runs for a specific project
qaos hist -p <project-id> -l 20
```

### Output columns

| Column       | Description                                                 |
| ------------ | ----------------------------------------------------------- |
| **ID**       | Shortened run ID                                            |
| **Status**   | `completed`, `failed`, or `in-progress`                     |
| **Score**    | Aggregate quality score (0–100), or `—` if not yet computed |
| **Issues**   | Number of problems detected                                 |
| **Duration** | How long the run took                                       |
| **Title**    | Run title                                                   |
| **URL**      | Site URL that was tested                                    |
| **Date**     | Date and time the run was created (UTC)                     |

<Note>You must be authenticated before running `qaos hist`. Run `qaos auth` first if you haven't already.</Note>

***

## Dashboard

The [QAOS Dashboard](https://qaos.machdel.com) provides a richer view of run history:

* Filter by project or status
* View full issue reports with reproduction context
* Compare runs over time to track improvement
* Export reports as PDF

Navigate to **Runs** in the sidebar to access the history view.

***

## Report contents

Each run report includes:

<CardGroup cols={2}>
  <Card title="Issue list" icon="list-check">
    All detected issues sorted by severity, with type, description, and location.
  </Card>

  <Card title="Task timeline" icon="timeline">
    Per-task breakdown showing what the agent did, how long it took, and what it found.
  </Card>

  <Card title="Fix recommendations" icon="wrench">
    Actionable guidance on how to resolve each detected issue.
  </Card>
</CardGroup>