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

# primerlab history

> CLI reference for the primerlab history command

View and manage primer design history.

## Synopsis

```bash theme={null}
primerlab history <subcommand> [options]
```

## Subcommands

| Subcommand | Description              |
| ---------- | ------------------------ |
| `list`     | List recent designs      |
| `show`     | Show details of a design |
| `export`   | Export history to CSV    |
| `stats`    | Show database statistics |
| `delete`   | Delete a design          |

## Examples

### List Recent Designs

```bash theme={null}
# Show last 10 designs
primerlab history list

# Show last 20 designs
primerlab history list --limit 20

# Filter by gene
primerlab history list --gene GAPDH

# Filter by workflow
primerlab history list --workflow qpcr
```

### Show Design Details

```bash theme={null}
primerlab history show 42
```

### Export to CSV

```bash theme={null}
primerlab history export --output primer_history.csv
```

### View Statistics

```bash theme={null}
primerlab history stats
```

### Delete a Design

```bash theme={null}
primerlab history delete 42
```

## Database Location

History is stored in SQLite at:

* Linux/macOS: `~/.primerlab/history.db`
* Windows: `%USERPROFILE%\.primerlab\history.db`