> ## Documentation Index
> Fetch the complete documentation index at: https://critiqor-71f5274a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# critiqor runs — List Your Agent Evaluation History

> critiqor runs lists all completed Critiqor observation sessions with their run ID, timestamp, trust level, and reliability summary. Key flag: --runs-dir.

`critiqor runs` prints a summary of every finalized observation session in your runs directory. Use it to review your evaluation history, locate a specific run, or confirm that a session was finalized correctly.

## Syntax

```bash theme={null}
critiqor runs [OPTIONS]
```

## What It Does

The command scans your runs directory and lists all finalized sessions. Each entry includes the run ID, timestamp, trust level, and a brief reliability summary. You can use the run ID with `critiqor dashboard` to open any session's full report.

## Options

| Flag         | Type   | Default | Description                          |
| ------------ | ------ | ------- | ------------------------------------ |
| `--runs-dir` | string | `runs`  | Directory to look for run artifacts. |

## Examples

```bash theme={null}
# List all runs
critiqor runs

# List runs from a custom directory
critiqor runs --runs-dir /path/to/my/runs
```

## Expected Behavior

Each line in the output represents one finalized run and includes its run ID, the time it was created, its trust level, and a brief reliability summary. Runs are listed in reverse chronological order so your most recent session appears first.

To open a specific run's full report, pass its ID to `critiqor dashboard`:

```bash theme={null}
critiqor dashboard run_001
```

## Common Use Cases

* **Review evaluation history** — quickly scan past sessions to track reliability trends over time.
* **Locate a specific run** — find the run ID for a session you want to revisit or compare.
* **Confirm finalization** — verify that a session was completed correctly before running policy checks.
