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

# ralphy ref

> Manage references (websites, social media)

## Summary

```bash theme={"dark"}
ralphy ref [options] [command]
```

**Example**

```bash theme={"dark"}
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 theme={"dark"}
  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 pack my-project-001                    # build/update the typed reference pack
  ralphy ref pack my-project-001 --show             # print the pack without rebuilding
  ralphy ref pack my-project-001 --add artifacts/refs/hero.png --type product --lock
  ralphy ref pack my-project-001 --mode product-shot  # report missing required ref types
  ralphy ref locate --image shot.jpg --object "label tab on the bottle" --top-k 3
  ```
</Expandable>