---
title: "ralphy ref"
description: "Manage references (websites, social media)"
---

{/* Auto-generated — edit `cli/commands/<verb>.ts` instead. Regenerate via `bun run docs:cli`. */}

## Summary

```bash
ralphy ref [options] [command]
```

**Example**

```bash
ralphy ref pull https://tiktok.com/@x/video/72939...
```

<Expandable title="Full reference">

**Flags**

| Flag | Description |
|---|---|
| `-h, --help` | display help for command |

**All examples**

```bash
ralphy ref pull https://tiktok.com/@x/video/72939...
ralphy ref pull https://a.com/x.png https://b.com/y.jpg --kind reference-image --project my-proj-001
ralphy ref pull --from-file urls.txt --kind reference-image --project my-proj-001
ralphy ref pull-site https://example.com --project my-proj-001
ralphy ref analyze my-reference-slug
ralphy ref blueprint my-reference-slug
ralphy ref check my-project-001                  # gate classifier on scenario.json
ralphy ref check --text "Old Spice style hero"   # gate classifier on a raw brief
ralphy ref locate --image shot.jpg --object "label tab on the bottle" --top-k 3
```

</Expandable>
