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

# ctpf runs

> Manage scan runs

List and delete scan runs.

## Commands

### `ctpf runs list`

List recent runs.

```bash theme={null}
ctpf runs list [--limit N]
```

**Options:**

| Option    | Default | Description                        |
| --------- | ------- | ---------------------------------- |
| `--limit` | 20      | Maximum number of runs to display. |

Displays a table with ID, Module, Target, Status, and timestamp for each run.

***

### `ctpf runs delete`

Delete a run and all associated data.

```bash theme={null}
ctpf runs delete <ID> [--yes]
```

**Arguments:**

| Argument | Description                                         |
| -------- | --------------------------------------------------- |
| `ID`     | Run ID. Supports partial IDs (first 8+ characters). |

**Options:**

| Option  | Description               |
| ------- | ------------------------- |
| `--yes` | Skip confirmation prompt. |

**Cascade behavior:**

Deleting a run also deletes:

* All findings associated with the run
* All evidence associated with those findings
* IPI callback hits linked to the run (if applicable)

**Examples:**

```bash theme={null}
# Delete with confirmation showing impact
ctpf runs delete f9e8d7c6
# Output:
# Delete run 'audit-2025-04-10'?
# This will also delete 12 findings and 3 evidence items.
# Confirm? [y/N]: y
# Deleted run with 12 findings and 3 evidence items.

# Delete without confirmation
ctpf runs delete f9e8d7c6 --yes
```

<Warning>
  Run deletion is permanent. Associated findings and evidence cannot be recovered. Consider exporting results before deletion if needed for compliance or audit purposes.
</Warning>

<Note>
  Partial ID matching requires at least 8 characters. If multiple runs match the prefix, you'll be prompted to use a longer ID.
</Note>