@koda-sl/baker-cli 0.186.1 → 0.187.0

package/README.md

@@ -2137,6 +2137,17 @@ baker images get j571abc123def
 baker images get j571abc123def --full
 ```
 
+### `baker images group <id>`
+
+List every image that arrived in the same set — the slides of one Instagram carousel, the images pulled off one scraped page. Carousel slides are authored to be read in order and usually only make sense together, so pull the set before using any one slide on its own.
+
+```bash
+baker images group j571abc123def
+baker images group --group-key "instagram:Cx7Ab9"
+```
+
+Returns the set's shared caption or page title, a link back to the original post/page, and the members in order — as both `images` and `videos`, since a carousel can mix stills and clips across the two libraries. Accepts an **image or a video id**, for the same reason: `baker videos group` is the same lookup from the other side.
+
 ### `baker images upload <file|url>`
 
 Add an image to the library — accepts a **local file path** or a **remote `http(s)://` URL**. The positional arg is sniffed: if it starts with `http://` or `https://`, the call dispatches to `/api/images/ingest` (hash-deduped on bytes + externalId, byte-fetch happens server-side); otherwise the local file is read, base64-encoded, and sent to `/api/images/upload`.
@@ -2320,10 +2331,25 @@ Upload a video file via Mux direct upload.
 ```bash
 baker videos upload ./demo.mp4
 baker videos upload ./demo.mp4 --dry-run
+baker videos upload ./testimonial-maria.mp4 \
+  --context "Testimonial from Maria, a real customer, filmed on her phone for the autumn campaign"
 ```
 
 Supported extensions: `.mp4`, `.mov`, `.webm`, `.avi`, `.mkv`
 
+`--context` describes what the clip is and what it's for. The analysis watches the frames and hears the audio, but it can't know which campaign a clip belongs to or whether the person on camera is a real customer or a hired actor — and those are what you'll search on later. The filename is sent automatically as a weaker hint.
+
+### `baker videos group <id>`
+
+List every asset that arrived in the same set as this clip — the other slides of the Instagram post it came from, stills included. A carousel is authored to be read in order, so a clip lifted out of one is usually missing half its meaning.
+
+```bash
+baker videos group xd7abc123def
+baker videos group --group-key "instagram:Cx7Ab9"
+```
+
+Same lookup as `baker images group` and takes either kind of id; the two exist so the noun you happen to hold does not decide whether you can ask.
+
 ### `baker videos delete <id>`
 
 Delete a video by ID.