# `once query evidence`

List durable evidence records, optionally filtered by subject.

## Synopsis

```text
once query evidence [OPTIONS] [SUBJECT]
```

## Description

Evidence records are provenance for action outcomes. They record what happened after `once exec`, `once run`, `once build`, `once lint`, or `once test`: the subject, status, action digest, input digest when available, an input fingerprint manifest for declared graph actions, cache state, exit code, and captured output digests when available. Fingerprint components expose only their category, label, and digest, not raw command or environment values. Evidence is queryable history; it does not change action-cache reuse rules.

## Arguments

| Argument | Required | Description |
| --- | --- | --- |
| `<SUBJECT>` | no | Subject id, e.g. `cli` or `cli:test`. |

## Options

| Flag | Value | Default | Description |
| --- | --- | --- | --- |
| `--limit` | `<COUNT>` |  | Return only the newest matching records. |