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

# pome inspect

> Print a human-readable report for a completed run.

`pome inspect` reads a run's artifacts and prints a human-readable summary: trace
health, recorded events, and per-criterion score verdicts. Use it after `pome run`
to debug failures directly in the terminal, without opening the dashboard.

## Usage

```bash theme={"dark"}
pome inspect <run> [options]
```

## Arguments

| Argument | Required | Description                                                                             |
| -------- | -------- | --------------------------------------------------------------------------------------- |
| `<run>`  | Yes      | Run id, path to a run directory, or `latest` (most recent run under `--artifacts-dir`). |

## Options

| Flag                    | Default | Description                                       |
| ----------------------- | ------- | ------------------------------------------------- |
| `--artifacts-dir <dir>` | `runs`  | Base directory where `pome run` writes artifacts. |

## Output

Prints:

* Run id and artifact directory path
* Trace health summary (event counts, gaps, proxy capture status)
* Rendered event timeline from `events.jsonl`
* Aggregate score and per-criterion pass/fail/skip lines from `score.json`

## Examples

```bash theme={"dark"}
# Most recent run
pome inspect latest

# Specific run directory
pome inspect runs/01-bug-happy-path/ses_abc123

# Custom artifacts location
pome inspect latest --artifacts-dir matrix-results
```

## Exit codes

| Code | Meaning                                                                                       |
| ---- | --------------------------------------------------------------------------------------------- |
| 0    | Report printed successfully.                                                                  |
| 2    | Legacy `events.jsonl` format detected (pre–FDRS-403 schema). Re-run with a current CLI build. |

## Related

Generate a fix prompt for a failed run:

```bash theme={"dark"}
pome fix-prompt runs/<task>/<run-id>/events.jsonl \
  runs/<task>/<run-id>/score.json \
  tasks/<task>.md
```