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

# CLI Reference: Evaluations

> Reference for starting, inspecting, cancelling, and downloading evaluations.

## Run and lifecycle

```text theme={null}
droyd eval run [--wait] [--allow-concurrent] [--manifest <path>]
               [--prev-node <ref>] [--dataset-role <role>] [--dataset-slug <slug>]
               [--concurrency <count>] [--max-workers <count>] [--title <title>]
               [--hypothesis <text>] [--analysis <text>] [--json]
droyd eval list [experiment-id] [--manifest <path>] [--json]
droyd eval status [evaluation-id] [--manifest <path>] [--json]
droyd eval cancel [evaluation-id] [--manifest <path>] [--json]
```

`--wait` polls until a terminal status. An omitted evaluation ID resolves to the
most recent workspace evaluation. `cancel` applies only to queued or running
evaluations.

`eval run` also forwards an optional `[eval.feedback_capabilities]` table from
the selected manifest. Capability names and values are competition-defined;
unsupported dataset or race combinations fail validation.

## Results and diagnostics

```text theme={null}
droyd eval logs [evaluation-id] [--manifest <path>] [--json]
droyd eval results [evaluation-id] [--manifest <path>] [--json]
droyd eval problem-results [evaluation-id] [--manifest <path>] [--json]
droyd eval episodes [evaluation-id] [--manifest <path>] [--json]
droyd eval traces [evaluation-id] [--manifest <path>] [--json]
droyd eval artifacts [evaluation-id] [--manifest <path>] [--json]
```

## Artifact downloads

```text theme={null}
droyd eval artifacts download [evaluation-id] [artifact-id]
      [--manifest <path>] [--output <path>] [--traces true] [--problems true]
      [--summary true] [--logs true] [--manifests true] [--system true] [--json]
```

The artifact selector can be a UUID or `all`; if omitted, all available
artifacts are selected. The default destination is inside the selected
experiment. See [Evaluations](/cli/evaluations) for examples and redaction
behavior.