@aicopycoders/exodus 2026.11.1200-beta.18 → 2026.11.1200-beta.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -401,7 +401,12 @@ and until it is delivered, it ends with no upload line: make no cut of your
401
401
  own, unless `status` says the app's cut didn't work and offers you to cut it
402
402
  yourself, and the member says yes.
403
403
 
404
- - Approve: `exodus video approve <runId>` makes the cut the ad. It is one-way.
404
+ - Approve: `exodus video approve <runId>` makes the cut the run's finished
405
+ video. Unless the run started from a template, it can't be undone; a change
406
+ after it is a new run. Nothing is posted to an ad account. The video stays
407
+ on the run page and in Video → Your ads, and `pull` saves it. A workflow
408
+ whose Output names a Drive folder, or that has a webhook, also sends it
409
+ there.
405
410
  - Redo a clip: `retry-clip` as at stop 4, after their yes. On a run the app
406
411
  cuts, it cuts again by itself (read `status`); on any other, pull, cut and
407
412
  upload again.
@@ -414,11 +419,10 @@ on those plans and downloaded from Suno."
414
419
 
415
420
  ## Swiping a video ad
416
421
 
417
- What Swipe a video does on the dashboard, from the terminal. Exodus breaks the
422
+ What Swipe a video does on the dashboard, from the terminal: Exodus breaks the
418
423
  competitor's ad down, matches it to the closest kind of ad and look it makes
419
424
  (the template), writes the brand's version, and starts the video on the kind
420
- the swipe wrote. The run is the same one Swipe a video starts on the
421
- dashboard.
425
+ the swipe wrote, the same run Swipe a video starts on the dashboard.
422
426
 
423
427
  These steps need Video switched on for the member's account. Without it every
424
428
  swipe command answers "Not found on this brand. The id is wrong or is another
@@ -429,17 +433,99 @@ them, and offer `ugc-swipe` (the script) instead of stopping: it swipes their
429
433
  ad's words into a script for their product, with no video. Offer it too when
430
434
  they want only the words.
431
435
 
432
- This path has no picks stop and no pilot clip. The run goes from the start
433
- straight to the storyboard (stop 3), and approving the storyboard makes every
434
- clip. A run started with `--one-shot` approves its own storyboard when its
435
- checks pass. Making the video from one of our formats (`--adapt`, "From one
436
- sentence to a film") keeps the picks stop and the pilot clip.
437
-
438
- By default a swipe is one round: you read the ad, send the member one sheet,
439
- and on their one yes write the brand's version and make each video they
440
- picked. When the member names no ad, the options come first (step 0): video
441
- ads from the brand's swipe library to pick from. A member who asks to say yes
442
- before each paid step gets "Step by step" below.
436
+ This path has no picks stop and no pilot clip: the run goes from the start
437
+ straight to the storyboard (stop 3), whose approve makes every clip, and a
438
+ `--one-shot` run approves it itself when its checks pass. A video made from
439
+ one of our formats (`--adapt`, "From one sentence to a film") keeps both.
440
+
441
+ By default a swipe is one round: read the ad, one question with the plan, and
442
+ on its yes write and make each video. When the member names no ad, the
443
+ options come first (step 0); "Step by step" asks before each paid step.
444
+
445
+ **How it talks.** Seven rules; the screens below are their templates (the
446
+ question's text, options and money line as written; the message in your words).
447
+
448
+ 1. **Decide, then show.** Pick every row you can (how close, where it stops,
449
+ music, the product, the recommended person and voice); the member edits it.
450
+ Rows that do nothing today (persona and mechanism while noted, not read;
451
+ the "not yet" lists) stay off the first screen.
452
+ 2. **Text first, then the question, in one reply.** The picker shows only its
453
+ question's text and each option's label and description, so a plan you
454
+ only thought never reaches the screen. Write the message as plain text
455
+ first (one or two lines: what you read, rule 7's cue; never the plan
456
+ twice), then call `AskUserQuestion`: its text holds the plan and the money
457
+ line in at most 3 short lines, then the question. No paragraph of reasons.
458
+ 3. **Ask with the `AskUserQuestion` tool** (1 to 4 questions, 2 to 4 options
459
+ each, a header of at most 12 characters, one line of description an option;
460
+ it adds "Other" by itself), the recommended option first with
461
+ "(Recommended)" only for a real reason. Where the tool is not there (it
462
+ errors, in a subagent, on a host without it), send the question's text and
463
+ the same options as a short numbered list after the message. A typed answer
464
+ always works. Step 0's six options stay a numbered list. One real option
465
+ gets a second ("Stop here", "None"). A row of more than four values (how
466
+ close has five; a long product or voice list) shows what it is now and the
467
+ nearest two or three, and names the rest in the question's text ("also:
468
+ Same arc") for "Other", or goes as a numbered list.
469
+ 4. **The option that spends carries its price in its label**, in the CLI's own
470
+ figures, or "no printed price" where it prints none: a verb, what it buys
471
+ in two or three words, the price. Its description starts with what it buys
472
+ in full. Never a figure you worked out, never a formula.
473
+ 5. **One money line**, in each paid step's question's text, right before the
474
+ question, and at the end: `Spent so far: $<X>`, each cost line the CLI
475
+ printed counted once, with whose money it was (never the team's and the
476
+ member's added up), and in brackets what printed no cost: `Spent so far:
477
+ $<X> on the team's keys for reading their ad (the template, on your model
478
+ key: not printed)`. On a run whose `status` prints "Cost so far:" or "Cost:"
479
+ (an admin key), of a kind whose price the member said yes to: `Spent $<X> of
480
+ about $<Y>`, X that line's figure, Y that price's "about". With no such
481
+ line, "the run's cost is not printed": never a figure, never that it was
482
+ free. Who pays is said once: the read's line (step 1), then the sheet's
483
+ spending option ("on your own keys", naming the Kie and ElevenLabs keys a
484
+ kind needs). Say a cost as the CLI printed it, each once ("It cost $<X> on
485
+ the member's key."): never a range, an average or an "about" of your own.
486
+ 6. **Progress is one line; a problem is two lines and a question** (step 4).
487
+ Narrate no command; wait on a run in the background (`exodus video wait
488
+ <runId>`) and speak when it is delivered or stops.
489
+ 7. **Details on request**, named once on the first screen: "show sheet", "show
490
+ script", "show people", "why" (step 3).
491
+
492
+ Rule 4's spending options, each figure the one the CLI printed for this swipe.
493
+ An option that runs a `--yes` line and has no row still carries the CLI's
494
+ figures or "no printed price" in its label, not only in its description:
495
+
496
+ | Ask | Label | Its description starts |
497
+ |---|---|---|
498
+ | The sheet | `Make 1 video · no printed price` (above 6: `Make 8 videos · no printed price`) | 1 script, then the video to its storyboard; the voices and clips wait for your yes there (one shot: the whole video, with no final approve). On your own keys. |
499
+ | The sheet, a write that makes people | `Write it · people about $…, at most $…` | 1 script (no printed price), <k> people to pick from, and the animal's picture ($…) if the script has one. The film waits for your yes on its price. |
500
+ | "Film it?" | `Film it · about $…, at most $…` | <k> takes at <size>. The cut plays them a little faster and shortens long pauses, so the video is shorter than its takes and can be shorter than their ad. … Not in the price: text calls on your model key, the word check on your ElevenLabs key, a second listen on your Kie key. |
501
+ | Their look | `Their look · about $…, at most $…` | One read of their speaker's look, then <k> new people and a check of their faces. Never their face. |
502
+ | More people | `<n> more people · at most $…` | <n> new people to pick from, on your model and Kie keys. Nothing is filmed. |
503
+ | A hold | `Film every take again · about $…, at most $…` | A new video from the same swipe. One take cannot be filmed alone. |
504
+ | A refused write | `Write again · no printed price` (with people: `Write again · people about $…, at most $…`) | The same write again, on your model key. A refused write is paid too. |
505
+ | Your own script | `Use my own script · no printed price` | Your lines word for word, made the way their ad is made, on your model key; people only when the script keeps their speaker's type. |
506
+ | Step by step; the read past its limit or again (step 1); a start on its own (a refused start, step 5's check) | `Read the ad · no printed price`, `Read the rest · <what is left> · no printed price`, `Read it again · no printed price`, `Make the template · no printed price`, `Write it · no printed price`, `Start it · no printed price` | What the line without its yes printed that it buys, and who pays: each breakdown on the team's keys, each template and write on your model key. A write with people is the sheet's "Write it" row; a start of a kind with a saved sheet, the "Film it?" row. |
507
+ | Mining (step 0) | `Mine them · no printed price` | Every active competitor on the watchlist, up to 50 in one run, on your Scrape Creators key. It starts at once. |
508
+ | The bot again (step 5) | `Call the bot again · no printed price` | One more text swipe call, on your Genesis and model keys. |
509
+
510
+ **What a yes is, at every question on this path**: the sheet, "Film it?", a
511
+ stop's "What now?", Their look, more people, and the storyboard stop and the
512
+ end approve when a swipe's run reaches them ("Stop 3: the storyboard" and "End:
513
+ watch and approve" say what each shows). Each paid
514
+ line (`--yes`, or an `approve` that buys) runs only after the member pressed an
515
+ option whose own label names what it buys and its price (or "no printed
516
+ price"), or typed a yes to that option ("go", "film it"; with the picker up, a
517
+ typed answer arrives as "Other"). It buys only what the pressed label, its
518
+ description and the question's text showed: a plan pick in none of them is not
519
+ covered, so ask again with it in the question. Its `--max-usd` or
520
+ `--people-max-usd` is that label's "at most". With two options that spend, a
521
+ bare "go" names neither: ask which. None of these is a yes: a press or a typed
522
+ pick of any other option ("Show me …", "Change something", a free look,
523
+ "Stop"); "ok", "thanks", "maybe" or "looks good" after something you showed; a
524
+ question, or a reply you are not sure of; a change with no yes in it; a picker
525
+ that errored, timed out or was closed; an answer from another agent when you
526
+ run as a subagent (then run nothing paid and hand the question back). Do what
527
+ was asked, then ask the same question again, with the price read again if a row
528
+ changed.
443
529
 
444
530
  **Long waits.** The CLI waits up to 25 minutes for a breakdown, 10 for a
445
531
  template, 15 for a write (the write always waits; it has no `--wait`) and 5
@@ -504,9 +590,9 @@ The rules of the options:
504
590
  **A find by kind.** When the member asks for a kind of ad ("find me some
505
591
  authority yappers"), offer at most six whose words sound like that kind, and
506
592
  say so in the message's first line, as "<kind>: sounds like, from the words;
507
- the read confirms it." After the reads, the sheet's first
508
- line names any ad the template read as another kind, so the member can drop
509
- it ("drop video 3, go" is already a yes).
593
+ the read confirms it." After the reads, the sheet's first line marks an ad the
594
+ template read as another kind in a few words ("ad 3: read as <kind>"), so the
595
+ member can drop it ("drop video 3, go" is already a yes).
510
596
 
511
597
  **What a pick is.** Only numbers given after an options message ("1, 3 and
512
598
  5"), or "all" (the options the member last saw), are picks. The numbering
@@ -608,54 +694,60 @@ zero, and a new template is unknown.
608
694
 
609
695
  Read one ad at a time: its breakdown, then its template. Before each read
610
696
  after the first (a template, or the next ad's breakdown), stop and ask the
611
- member once when the costs counted have reached $0.50, or when any read so
612
- far is unknown: an unknown cost counts as reaching the limit. Say what is
613
- left to read. A new template is always
614
- unknown, so with several ads you read the first and ask before the rest. The
615
- check comes before each read, so the total can pass $0.50 by one read. Ads
616
- the member picked by number from the options (step 0), or with "all", are
617
- already a yes to read: read every picked ad without this ask. The ask still
618
- comes before any ad they did not pick.
619
-
620
- A breakdown or a template that fails prints why. With one ad, tell the
621
- member and stop. With several, leave that ad out, say so in the sheet's first
622
- line, and go on with the others. Reading again is paid too, and needs their
623
- yes.
697
+ member once when the costs counted have reached $0.50, or when any read so far
698
+ is unknown: an unknown cost counts as reaching the limit. Say what is left to
699
+ read. A new template is always unknown, so with several ads you read the first
700
+ and ask before the rest. The check comes before each read, so the total can
701
+ pass $0.50 by one read. Ads the member picked by number from the options (step
702
+ 0), or with "all", are already a yes to read: read every picked ad without
703
+ this ask. The ask still comes before any ad they did not pick. Ask it as a
704
+ question whose text ends with the money line: "Read the rest · <what is left>
705
+ · no printed price", or "Stop here".
706
+
707
+ A breakdown or a template that fails prints why. With one ad, tell the member
708
+ and stop. With several, leave that ad out, mark it in a few words on the
709
+ sheet's first line ("ad 2: not read"), and go on with the others.
624
710
 
625
711
  ### 2. Read the choices
626
712
 
627
- Free, and no yes: `exodus segment personas` (the saved personas; leave out
628
- the ones marked `[archived]`) and `exodus primer show` (its MECHANISM
629
- section; with no primer saved, say so once and offer only the member's own
630
- words or none). The products came in step 1.
713
+ Free, and no yes: `exodus segment personas` (the saved personas; leave out the
714
+ ones marked `[archived]`) and `exodus primer show` (its MECHANISM section;
715
+ with no primer saved, the mechanism row offers only the member's own words or
716
+ none). The products came in step 1.
631
717
 
632
718
  ### 3. The sheet, once
633
719
 
634
- Send this in one message, in this order, then stop and wait:
635
-
636
- > I read your ad as <kind of ad>, <look>, <n> lines, about <s> s. The swipe
637
- > makes that kind of ad. Say "show me" for the shot list and the script.
638
- > One sheet, answer once (my picks are marked):
639
- > 0. **Let it run** (I pick every row) or **I choose**.
640
- > 1. **Persona** (noted; the video writer does not read it yet): <your three best fits, each with a short reason>, show all <N>, or none. Pick several for one video each.
641
- > 2. **Mechanism** (noted; the video writer does not read it yet): <the primer's mechanisms>, your own words, or none.
642
- > 3. **How close:** 1 Mirror, 2 Close, 3 Same beats, 4 Same arc, 5 Pattern only.
643
- > 4. **Characters:** the tool picks them (your saved characters: not yet).
644
- > 5. **Run:** one shot, or stop at the storyboard.
645
- > 6. **Finish:** music on or off (captions, speed, cuts: not yet).
646
- > **How many:** <n> videos = <a> ads × <p> personas:
647
- > - Video 1: <ad> × <persona>
648
- > - Video 2: <ad> × <persona>
649
- > **Cost:** no price before the write, but for the people a write makes (in It buys); a kind with a saved sheet gets its price after it.
650
- > **My picks:** <one line, with the reason>. **It buys:** <n> scripts and <n>
651
- > whole videos, on your keys. Say go, or change a row. (Above 6 videos, end
652
- > with "Say yes to <n> videos, or change a row." instead.)
720
+ Send the sheet as one reply, its message as text first and its question after
721
+ it (rule 2), then stop and wait. The message:
722
+
723
+ > Read your ad: <length>, <who is in it>, <how it is cut>. (several ads: one sheet for all, a few words each)
724
+ > Say "show sheet", "show script" or "why" · "personas": <N> saved, several make one video each, <noted only | written in by the text swipe bot> (only when the brand has some) · "mechanism" (only when step 5's path is open)
725
+
726
+ Its question (`AskUserQuestion`, header "Make it?"), its text:
727
+
728
+ > <the kind the swipe makes> for <product> · Script <how close, in words> · Stop <at the storyboard, before the paid clips | at the end, with no final approve> · Music <off | on, on your ElevenLabs key>
729
+ > Videos <n> = <a> ads × <p> personas: 1 <ad> × <persona>, 2 … (only when more than one) · Persona and mechanism: <the picks>, <written in by the text swipe bot | noted only: the videos differ only as two writes do> (only when picked)
730
+ > Spent so far: $<X> on the team's keys for reading their ad (the template, on your model key: not printed). Make it?
731
+
732
+ Its options: 1. the spending option (the table) 2. another way, only when
733
+ there is one, such as One-take UGC when the template offered it 3. Change
734
+ something: the product, how close, where it stops, music 4. Stop.
735
+
736
+ "Change something" asks the rows as questions (rule 3), what each is now first,
737
+ marked "(now)", then sends the sheet again. "show sheet" prints every row as
738
+ `swipe-sheet.md` (beside this file) lays it out. "show script" is their ad's
739
+ script (`status --full`, free), and after the write the written one with its
740
+ direction, Kept and Changed; "show people", each person made with their
741
+ picture's address, and the voices when the sheet has a `voice` row; "why", your
742
+ reasons, one line each.
653
743
 
654
744
  **The yes covers only the list the member last saw.** Before any write or
655
- start, the member has seen the list and the count, and said yes to them.
656
- This holds also when their first message says "just do it" or "let it run":
657
- "Let it run" fills the rows with your picks, and the yes still comes from
658
- the member.
745
+ start, the member has seen the list and the count, and said yes to them. This
746
+ holds also when their first message says "just do it" or "let it run": "Let it
747
+ run" fills the rows with your picks, and the yes still comes from the member.
748
+ The yes is as "What a yes is" says. A typed change with no yes in it: make the
749
+ change, send the sheet again with its price, and ask again. Each "wait" below
750
+ asks the question again.
659
751
 
660
752
  - A reply that makes the buy bigger is not the yes, even with "go" in it:
661
753
  more videos, another ad, music on where the sheet said off, or "one shot"
@@ -665,10 +757,11 @@ the member.
665
757
  "go", is the yes: how close, music off, or leaving out videos it names
666
758
  ("drop video 3, go"). Say the change in one line and start. "Fewer" with
667
759
  no say in which ones is not the yes: send the shorter list and wait.
668
- - Anything else is not the yes: a question, "show me", "maybe", "looks
669
- good?", or a reply you are not sure of. Answer it and wait. Above 6 videos,
670
- only a yes that names the count is the yes ("yes to 8 videos", "8, go"); a
671
- bare "go" or "yes" gets the count asked again.
760
+ - Above 6 videos, only a yes that names the count is the yes ("yes to 8
761
+ videos", "8, go"); a bare "go" or "yes" gets the count asked again. So above
762
+ 6 videos the spending option names the count ("Make 8 videos · …"), and its
763
+ press is a yes that names it; a numbered list ends "That is 8 videos. Say
764
+ yes to 8 videos."
672
765
  - On a sheet of 1 video, "1: Anna, Ben and Cara. Go." is 3 videos: send the
673
766
  list of 3 and wait.
674
767
 
@@ -683,159 +776,137 @@ The rows:
683
776
  - **One-take UGC** (`--kind ugc-one-take`): one person talks to the camera,
684
777
  each 15 or 25 seconds of the script filmed as one long take. It is open to
685
778
  admins only for now: for anyone else the CLI refuses it, so don't offer it
686
- to them. Use it when the member asks for a one-take UGC video or names
687
- Luke's UGC method, and then the sheet's first line says the swipe makes
688
- one-take UGC. Use it too when the template prints "Also fits their ad:
779
+ to them. Take it when the member asks for a one-take UGC video or names
780
+ Luke's UGC method. Use it too when the template prints "Also fits their ad:
689
781
  One-take UGC (ugc-one-take). …" and the member asked for a UGC video of one
690
782
  person talking to the camera, in any words: the word "one-take" is not
691
- needed. Then take it: in the sheet's first line, in place of "The swipe
692
- makes that kind of ad.", say in one line that the swipe makes One-take UGC,
693
- with the reason the template's line gives; One-take UGC is then the kind
694
- made. The write carries `--kind ugc-one-take`, its dry run first (People,
695
- below), and the sheet's yes is the yes to it. The line comes only for an ad
696
- its write takes and a member who may start it. When the line comes and the
697
- member asked for nothing it fits, name it in the sheet's first line as one
698
- option beside the kind the swipe makes, with the reason that line gives.
699
- Then add `--kind ugc-one-take` to the write only on the member's yes; never
700
- choose it unasked. A reply that picks it is not the yes yet: run its write line with
701
- `--kind ugc-one-take` and no `--yes` (free; People, below) for the people's
702
- price, send the sheet again with **It buys:** in the saved sheet's form, and
703
- wait for the yes. A sheet run (`exodus video swipe run --sheet <file>`) of
704
- one ad that names no kind prints the same line, ending "set "kind":
705
- "ugc-one-take" in the sheet before its next run.": set it only on their yes,
706
- and say that the next run writes that ad again, which is paid. On an ad it
707
- can't be made from, the write refuses it and says why. It buys a face photo,
708
- a picture of the room, a cut-out of the product, a picture of an animal when
709
- the script puts one in the picture, and one take for each 15 or 25 seconds of
710
- script, on the member's Kie key, and text calls on their model key; it needs their ElevenLabs key and their Kie key. Its price is the
711
- server's estimate, known once the swipe is written: `exodus video swipe
712
- sheet price <swipeId>` (free) prints it at 720p or a 480p draft, the whole
713
- video or the first take only, each with the most it can cost. The "about"
714
- films each take once. A take filmed again (as when a filming left out
715
- script words that matter) is paid again, so the run can cost more than
716
- "about"; the "at most" counts each take and picture made twice. On an admin
717
- key, plain `exodus video status` prints a line that starts "Cost so far:"
718
- or "Cost:" once the run has spent anything: that is the run's own cost, the
719
- figure the dashboard shows, and the line says what is not in it (what the
720
- swipe paid for before the run). When it prints none, no cost is recorded
721
- yet: say so, and never call the run free.
722
- - **The saved sheet** (a kind that has one; One-take UGC today). The server
723
- keeps one for each swipe of such a kind, made after its write. For such a
724
- video this sheet's yes covers the write and its people only, and **It
725
- buys:** says so: "<n> scripts now, each with <k> people to pick from and
726
- the animal when its script puts one in the picture (at most $<most> for each
727
- script's people and animal); each video after your yes on its saved sheet",
728
- with the people's part only when the dry write printed their price (People,
729
- below). The saved sheet and its yes come in step 4.
730
- - **People** (a kind whose write can make them: One-take UGC, when the
731
- server offers people to pick from). Before you
732
- send the sheet, run that video's write line (step 4) without `--yes`: it
733
- writes nothing and pays for nothing. When the kind makes people, it prints
734
- "This write also gives the sheet <k> people to pick from, …", their price
735
- ("About $… for new people: …" and "At most $… in all: …") and the line to
736
- run: "On their yes, run the same command with --yes --people-max-usd
737
- <most>". Put that most on the sheet, as above: the sheet's yes is the yes to
738
- it. The same price names the animal: "A picture of the animal, if the
739
- script puts one in the picture: $…". With that yes, the write also reads the
740
- stored script for an animal it puts in the picture (the dog in a dog
741
- product's ad) and draws one picture of it with the people, inside the same
742
- most. The saved sheet shows it on the row "The animal", with its picture;
743
- `exodus video swipe sheet set <swipeId> animal=none` takes it out of the
744
- video (free). With no animal in the script the row says "No animal in the
745
- script." and no picture is paid for. When the member gave a money limit and the people's most, added over
746
- every video on the sheet, is already over it, say so on the sheet and ask:
747
- no write goes out until what it can cost fits. When it prints no people's
748
- price, the write makes none. When the member
749
- wants no people, the write takes `--no-people`, and the sheet says so. Two
750
- more writes make none, and nothing is paid for them. A member's own
751
- script (`their-format`) that keeps its own person (the "Persona and
752
- mechanism" row below says when) makes none even with the figure; the write prints
753
- "No people were made with this write: the script keeps no type of their
754
- speaker to make them from. Nothing was paid for them. …". A video that step
755
- 5 writes is written with a plain `--yes`, which makes none; it prints "No
756
- people to pick from were made with this write: its yes carried no
757
- --people-max-usd. …". So leave the people out of **It buys** for a step 5
758
- video, and for the member's own script say its people are made only when the
759
- script keeps their speaker's type. Either way the member can ask for people
760
- on the saved sheet: `exodus video swipe sheet people <swipeId>`, the price
761
- first.
762
- - **Persona.** Offer the three saved personas that fit the ad best, each with
763
- a short reason, then "show all <N>" (every persona not marked
764
- `[archived]`). Several may be picked: one video for each.
783
+ needed. Then take it: the plan says the swipe makes One-take UGC, with the
784
+ reason the template's line gives; One-take UGC is then the kind made. The
785
+ write carries `--kind ugc-one-take`, its dry run first (People, below), and
786
+ the sheet's yes is the yes to it. The line comes only for an ad its write
787
+ takes and a member who may start it. When the line comes and the member
788
+ asked for nothing it fits, offer it as one option of the sheet's question,
789
+ beside the kind the swipe makes, with the reason that line gives; never
790
+ choose it unasked. A press or a typed pick of it is not the yes yet: run its
791
+ write line with `--kind ugc-one-take` and no `--yes` (free; People, below),
792
+ and send the sheet again with that price. A sheet run (`exodus video swipe
793
+ run --sheet <file>`) of one ad that names no kind prints the same line,
794
+ ending "set "kind": "ugc-one-take" in the sheet before its next run.": set
795
+ it only on their yes, and say that the next run writes that ad again, which
796
+ is paid. On an ad it can't be made from, the write refuses it and says why.
797
+ It buys a face photo, a picture of the room, a cut-out of the product, a
798
+ picture of an animal when the script puts one in the picture, and one take
799
+ for each 15 or 25 seconds of script, on the member's Kie key, and text calls
800
+ on their model key; it needs their ElevenLabs key and their Kie key. Its
801
+ price, the server's estimate, comes after the write (step 4). The "about"
802
+ films each take once. A take filmed again (as when a filming left out script
803
+ words that matter) is paid again, so the run can cost more than "about"; the
804
+ "at most" counts each take and picture made twice. On an admin key, plain
805
+ `exodus video status` prints a line that starts "Cost so far:" or "Cost:"
806
+ once the run has spent anything: that is the run's own cost, the figure the
807
+ dashboard shows, and the line says what is not in it (what the swipe paid
808
+ for before the run). When it prints none, no cost is recorded yet: say so,
809
+ and never call the run free.
810
+ - **The saved sheet** (One-take UGC today) comes after the write, with its
811
+ own yes (step 4). This sheet's yes covers their write and its people only,
812
+ and the spending option says so, with the people's part only when the dry
813
+ write printed their price (People, below).
814
+ - **People** (a kind whose write can make them: One-take UGC, when the server
815
+ offers people to pick from). Before you send the sheet, run that video's
816
+ write line (step 4) without `--yes`: it writes nothing and pays for nothing.
817
+ When the kind makes people, it prints "This write also gives the sheet <k>
818
+ people to pick from, …", their price ("About $… for new people: …", "A
819
+ picture of the animal, if the script puts one in the picture: $…" and "At
820
+ most $… in all: …") and the line to run: "On their yes, run the same command
821
+ with --yes --people-max-usd <most>". Those figures go in the spending option
822
+ ("Write it" in the table, each video's as printed): the about from "About $…
823
+ for new people" (the people only; the animal's own line goes in the
824
+ description) and the most from "At most $… in all". Its press is the yes to
825
+ that most. With it, the write also draws the animal its stored script puts
826
+ in the picture (the dog in a dog product's ad) with the people, inside the
827
+ same most; `exodus video swipe sheet set <swipeId> animal=none` takes it out
828
+ of the video (free). When the member gave a money limit and the people's
829
+ most, added over every video on the sheet, is already over it, say so in one
830
+ line of the plan and ask: no write goes out until what it can cost fits.
831
+ When it prints none, the write makes no people. Nor does `--no-people`. Two
832
+ more writes make none, and nothing is paid for them: a member's own script
833
+ (`their-format`) that keeps its own person (the "Persona and mechanism" row
834
+ below says when), and a video that step 5 writes, written with a plain
835
+ `--yes`; each write says so. So leave the people out of a step 5 video's
836
+ option, and for the member's own script its description says its people are
837
+ made only when the script keeps their speaker's type. Either way the member
838
+ can ask for people on the saved sheet: `exodus video swipe sheet people
839
+ <swipeId>`, the price first.
840
+ - **Persona.** Pick none unless the member named one. "personas" asks the three
841
+ that fit the ad best, each with a short reason, as one question that takes
842
+ several picks, and "show all <N>" lists every one. "mechanism" asks the
843
+ primer's mechanisms (step 2), the member's own words, or none.
765
844
  - **Persona and mechanism.** The video writer reads neither. When step 5's
766
845
  path is open, the text swipe bot writes them into each video's lines, and
767
846
  the rows say so (step 5). When it is closed, and for a video the bot does
768
- not write, they are noted, not read: in
769
- **My picks**, a persona or a mechanism always carries "(noted, not used
770
- yet)", the primer's lead mechanism included, and videos for two personas
771
- differ only as two writes of the same request differ. In that case, when
772
- more than one persona is picked, say this in your reply before the yes, so
773
- the member does not pay for several videos expecting a script for each
774
- persona. Two other ways make a persona real without step 5. The member
775
- writes their own script for that persona, and the write takes it with
776
- `--mode their-format --script <file>`, made the way their ad is made. For
777
- a kind whose sheet has a person (One-take UGC today), who is filmed
847
+ not write, they are noted, not read: on "show sheet", a persona or a
848
+ mechanism always carries "(noted, not used yet)", the primer's lead
849
+ mechanism included, and videos for two personas differ only as two writes of
850
+ the same request differ. In that case, when more than one persona is picked,
851
+ the plan's personas line says so ("noted only: the videos differ only as two
852
+ writes do"), so the member does not pay for several videos expecting a
853
+ script for each persona. Two other ways make a persona real without step 5.
854
+ The member writes their own script for that persona, and the write takes it
855
+ with `--mode their-format --script <file>`, made the way their ad is made.
856
+ For a kind whose sheet has a person (One-take UGC today), who is filmed
778
857
  depends on the script. One that names no speaker, and does not make its
779
858
  speaker the other sex from their ad's speaker, is cast as their ad's
780
859
  speaker's type: the write puts that type on the script's cast line. A
781
860
  speaker label that is not a placeholder ("Maya:", not "Speaker:"), a name
782
861
  the script says ("Hi, I'm Jess"), its own words about the speaker, or words
783
- that make the speaker the other sex keep the script's own person. The
784
- saved sheet's person row says which, and why. To film the persona's own
785
- person, the script names its speaker, or the member sets `who` on the
786
- saved sheet. Or the member swipes the words with the `swipe` skill and
787
- makes the film from one of our formats (its "Make it a video"). That path
788
- asks a yes before each paid step, and it makes the film in the format they
789
- pick, not in the ad's own kind and look.
862
+ that make the speaker the other sex keep the script's own person. The saved
863
+ sheet's person row says which, and why. To film the persona's own person,
864
+ the script names its speaker, or the member sets `who` on the saved sheet.
865
+ Or the member swipes the words with the `swipe` skill and makes the film
866
+ from one of our formats (its "Make it a video"). That path asks a yes before
867
+ each paid step, and it makes the film in the format they pick, not in the
868
+ ad's own kind and look.
790
869
  - **Characters.** A swiped run takes no saved characters, so the row offers
791
- only "the tool picks". A kind whose write makes people (People, above)
792
- has its person picked on the saved sheet, in step 4.
793
- - **Run.** With "stop at the storyboard", the line reads **It buys:** <n>
794
- scripts, and <n> storyboards with their pictures; the voices and clips
795
- wait for your yes at each storyboard. With "one shot", the film is
796
- delivered by itself once the app's cut is made, with no final approve: say
797
- so in **My picks** when one shot is picked.
870
+ only "the tool picks". People a write makes are picked in step 4.
871
+ - **Run.** "Stop at the storyboard" buys the scripts and the storyboards with
872
+ their pictures; the voices and clips wait for your yes at each. "One shot"
873
+ has no final approve (step 4): the plan's Stop line says so.
798
874
  - **Finish.** `swipe start` takes `--music` and nothing else for the finish.
799
- Music is made on the member's own ElevenLabs key. Caption style, speed,
800
- jump cuts and the end card come with a later update.
875
+ Music is made on the member's own ElevenLabs key. Music is off unless the
876
+ member asked for it; the plan's line says which. Caption style, speed, jump
877
+ cuts and the end card come with a later update.
801
878
  - **How many.** Ads × personas, with none counting as one persona and the
802
879
  characters counting as one today. Show the multiplication, as in "4 videos
803
- = 2 ads × 2 personas". Above 6 videos, say the count and ask for the yes on
804
- that count in so many words: "That is 8 videos. Say yes to 8 videos."
805
- - **Cost.** Before the write the CLI prints no price for a swipe, so the
806
- sheet says exactly that: no number, no range, no guess. A kind with a saved
807
- sheet (One-take UGC today) gets its price after the write, with its saved
808
- sheet (step 4). The people its write makes are priced before it (People,
809
- above). A kind with no saved sheet prints no price before its write or its
810
- start, so the member sees no figure before the yes: say so on the sheet.
811
- When the member gave a money limit ("under $27"), say too that this kind
812
- prints no price, so the limit cannot be checked against one before the yes.
813
- Only when the template offered One-take UGC for this ad ("Also fits their
814
- ad: …"), say that it prints a price before its start, and that its start is
815
- refused when it can cost more than the "at most" shown. Ask how they want to
816
- go on, and wait. The Director block of `exodus video
817
- status` prints "Spent: $… of $12.00": the $12.00 is the Director's limit
818
- for its redos on that video, not a price and not a ceiling for the first
819
- pass. Never quote it as the cost.
820
- - **Product.** Add a row **Product:** only when `swipe products` lists more
821
- than one. With one, write for that one.
880
+ = 2 ads × 2 personas".
881
+ - **Cost.** Before the write the CLI prints no price for a swipe: the option's
882
+ "no printed price" says so, and no other line about cost goes on the screen.
883
+ With a money limit and a kind with no saved sheet, add one line: "This kind
884
+ prints no price, so I can't check your $<limit> before the yes." There, when
885
+ the template offered One-take UGC for this ad ("Also fits their ad: …"), its
886
+ option's description says it prints a price before its start, held to its "at
887
+ most". The Director block of `exodus video status` prints "Spent: $… of
888
+ $12.00": the $12.00 is the Director's limit for its redos on that video, not
889
+ a price and not a ceiling for the first pass. Never quote it as the cost.
890
+ - **Product.** Ask the product only when `swipe products` lists more than one
891
+ and the member named none. With one, write for that one.
822
892
  - **Anything else.** Add a row only when the member's ask carried a note. A
823
893
  note that names what to swipe (hook only, their format with their own
824
894
  script, a new look) sets `--mode` (step 4), and **My picks** says the mode
825
- back. Say back any other note as noted, not used yet.
826
- - **Several ads.** One sheet covers every ad the member named: list what you
827
- read from each in the first line. The count and the warning above 6 hold.
895
+ back. So does the plan. Say back any other note in one line, as noted, not
896
+ used yet.
828
897
 
829
- **The videos, in a fixed order.** List them one per line: the ads in the
898
+ **The videos, in a fixed order.** List them in this order: the ads in the
830
899
  order the member gave them, and for each ad the personas in the order the
831
900
  sheet shows them. The same picks give the same list.
832
901
 
833
- **A bare number.** Read a reply of only a number ("3") as the count of
834
- videos, and say so in the list's first line: "I read 3 as 3 videos." Pick
835
- one video for each ad, in the order given, before a second persona for any
836
- ad; then the next persona in the order shown for each ad, and so on, until
837
- the count is reached. List the videos in the fixed order and wait for the
838
- yes. When the picks cannot make that many, say how many they can make.
902
+ **A bare number.** After a numbered list of options (rule 3's fallback), a
903
+ number picks that option, as a press does. Anywhere else, read a reply of only
904
+ a number ("3") as the count of videos, and say so in the list's first line: "I
905
+ read 3 as 3 videos." Pick one video for each ad, in the order given, before a
906
+ second persona for any ad; then the next persona in the order shown for each
907
+ ad, and so on, until the count is reached. List the videos in the fixed order
908
+ and wait for the yes. When the picks cannot make that many, say how many they
909
+ can make.
839
910
 
840
911
  When the member says "just do it": no persona, the primer's lead mechanism
841
912
  (noted, not used yet), closeness 2, the tool picks the characters, one shot,
@@ -844,40 +915,53 @@ no music. With more than one product and none named, ask that one row first.
844
915
  ### 4. On the yes
845
916
 
846
917
  The yes covers the writes and the starts, and the bot calls when step 5
847
- applies; nothing else. The breakdown and the template are once per ad, and
848
- are done already.
849
-
850
- **The saved sheet** changes this for a kind that has one (One-take UGC
851
- today): the yes of step 3 covers its writes, and its starts wait for one more
852
- yes. Run step 1 for every such video first. Then read each one's saved sheet
853
- with `exodus video swipe sheet <swipeId>` (free) and show them one time,
854
- together in one message: their rows (with each person made, their picture's
855
- address, and the one recommended, when the sheet shows them), and the swipe's dashboard page each
856
- prints (that page does not show the saved sheet yet). Ask one yes for all
857
- their starts, then run step 2 for each. A reply that only changes a row is
858
- not that yes: set it with `exodus video swipe sheet set <swipeId>
859
- notes="<words>"` (free; `<row>=` clears a row), say the change in one line,
860
- and ask the yes again. Say a row marked "no step reads it yet" as saved, not
861
- used. The start copies the saved sheet into the video; a change after it is
862
- for the next video.
863
-
864
- **Recommended rows.** A row may print `recommended:` and a reason: a value
865
- worked out for this swipe. Today that can be the person (`who`), the voice
866
- (`voice`), what the person holds (`prop`), the kind of opening (`hookKind`)
867
- and the text card at the start (`headline`). Show each with its reason. "Let
868
- it run" here, said in reply to these saved sheets and their prices, is the yes
869
- to the starts with the sheets as they stand: set nothing (a size a money
870
- limit needs is set before the sheets are shown, below), since a start with no pick films every recommended value
871
- and every other row's default. A "let it run" said before them, as in the
872
- first message, is not this yes: the writes went on the yes to step 3's sheet,
873
- and the starts wait for a reply to these. When people were made but the person row recommends none,
874
- a start with no pick films a new person, not one of them: the write and the
875
- start say so, and the member picks with `who=<n>` if they want one of them. A
876
- member's pick wins (the row then reads `from you:`). `<row>=` clears a pick,
877
- and the row goes back to its recommended value or default. `prop=none` holds
878
- nothing through the video (it prints `prop: none (nothing held through the
879
- video)`), though a take may still pick up a small thing for a moment, such as
880
- a mug or a drink; `prop=` takes it back to its default.
918
+ applies; nothing else (the read is done).
919
+
920
+ **The saved sheet** (step 3's row) changes this: the yes of step 3 covers its
921
+ writes, and its starts wait for one more yes. Run step 1 for every such video
922
+ first. Then read each one's saved sheet and its price, both free (`exodus
923
+ video swipe sheet <swipeId>` and `exodus video swipe sheet price <swipeId>`),
924
+ and send one reply for all their starts, its message as text first (rule 2):
925
+
926
+ > Script ready: <n> lines, <k> takes. Say "show sheet", "show script" or "why"
927
+
928
+ Its question (`AskUserQuestion`, header "Film it?"), its text:
929
+
930
+ > It opens: "<its first line>". (several videos: one line for all, each video's number, first words and person, and no Person line)
931
+ > Person: <name>, the recommended one of <k> | a new person cast from their speaker's type (or the words the write names), none of the <k> made · Voice: <name><, not <accent> like their speaker: "Change something" picks another> (Person only when the sheet has people, Voice only with a `voice` row; "not <accent>" only when `status --full`'s Cast names their speaker's accent and the voice row's reason, or the voice's name as `sheet voices` prints it, shows another or none)
932
+ > Spent so far: $<X> on the team's keys for reading their ad, $<W> on yours (the template, on your model key: not printed). Film it?
933
+
934
+ Its options: 1. Film it (the table), its figures from the price's "Price:"
935
+ line 2. Show me the script and the <k> people 3. Change something: person,
936
+ voice, size, how it is filmed, their look 4. Stop.
937
+
938
+ With several videos, the label says how many and the description each one's
939
+ price as printed, never their sum. Each start's `--max-usd`, and each write's
940
+ `--people-max-usd`, is that video's own printed "at most", never a sum. "show sheet" prints each saved sheet's rows
941
+ (with each person made, their picture's address, and the one recommended, when
942
+ the sheet shows them) and the swipe's dashboard page each prints, whose
943
+ Pre-production card on Your version shows the same picks: a change made there
944
+ is to this same saved sheet, so read it and its price again. A press of "Film
945
+ it", or a typed yes to it, is the one yes for all their starts: run step 2 for
946
+ each. A reply that only changes a row is not that yes: set it with `exodus
947
+ video swipe sheet set <swipeId> notes="<words>"` (free; `<row>=` clears a row),
948
+ read the price again, say the change in one line, and ask again. Say a row
949
+ marked "no step reads it yet" as saved, not used. The start copies the saved
950
+ sheet into the video; a change after it is for the next video.
951
+
952
+ **Recommended rows.** A row may print `recommended:` and a reason ("why" gives
953
+ it): today `who`, `voice`, `prop` (what the person holds), `hookKind` and
954
+ `headline`. "Let it run" here, said in reply to these saved sheets and their
955
+ prices, is the yes to the starts with the sheets as they stand: set nothing (a
956
+ size a money limit needs is set before the sheets are shown, below), since a
957
+ start with no pick films every recommended value and every other row's default.
958
+ A "let it run" said before them, as in the first message, is not this yes: the
959
+ writes went on the yes to step 3's sheet, and the starts wait for a reply to
960
+ these. A member's pick wins (the row then reads `from you:`); `<row>=` clears
961
+ it, back to the recommended value or default. `prop=none` holds nothing through
962
+ the video (it prints `prop: none (nothing held through the video)`), though a
963
+ take may still pick up a small thing for a moment, such as a mug or a drink;
964
+ `prop=` takes it back to its default.
881
965
 
882
966
  `who` is the person filmed: a person made for the swipe, by number
883
967
  (`who=<n>`), or words in the row's own form, as `who="a white woman in her
@@ -886,38 +970,38 @@ script decides.
886
970
  **Their look.** When the member wants the person to look like their speaker
887
971
  ("make her look like the woman in their ad", closer to, the same as), the row
888
972
  is "How close to their speaker" (`basedOn`): `type`, the default (a new person
889
- of their speaker's type), or `look`: new people who also have their
890
- speaker's hair, clothes, nails, skin tone, brows, makeup, freckles and build,
891
- read from their ad in our words, never their face, a name, a tattoo, a scar or
892
- a birthmark. Their age stays the type's. Never write `who` by hand for this.
973
+ of their speaker's type), or `look`: new people who also have their speaker's
974
+ hair, clothes, nails, skin tone, brows, makeup, freckles and build, read from
975
+ their ad in our words, never their face, a name, a tattoo, a scar or a
976
+ birthmark. Their age stays the type's. Never write `who` by hand for this.
893
977
  `exodus video swipe sheet set <swipeId> basedOn=look` with no `--yes` buys
894
978
  nothing: it prints the price (one read of their speaker's look on the member's
895
979
  OpenRouter key, then 4 new people and the check of their faces) and the line
896
- that says yes. Say that price to the member; only on their yes run it with
897
- `--yes --people-max-usd <the most it showed>`, then read the sheet a few
898
- minutes later and show the people made from it. `basedOn=type` goes back, free.
899
- When the row offers only `type`, it says why (no OpenRouter key, a well-known or
980
+ that says yes. Ask it as a question whose option carries that price ("Their
981
+ look · about $…, at most $…", the table); only on its yes run it with `--yes
982
+ --people-max-usd <the most it showed>`, then read the sheet a few minutes
983
+ later and show the people made from it. `basedOn=type` goes back, free. When
984
+ the row offers only `type`, it says why (no OpenRouter key, a well-known or
900
985
  named speaker, their ad's video not kept, a read that failed): say that reason
901
- and do not work around it. A sheet with no `basedOn` row has no such choice for
902
- this swipe: say so, and keep `who`.
903
- `filmed`, `pose`, `prop`, `moves`, `place`, `look`, `time`, `placeNote`: how
904
- and where it is filmed, each with its default's reason; set one only when the
905
- member asks (`time=dusk`). `notes` end every take's prompt.
906
- `hook` is take 1's opening action, `off` or a level from 1 to 5 (2 is the
907
- usual), and `hookKind` its kind (`any`, or one the row lists), each with
908
- its default's reason; set one only when the member asks (`hook=3`,
909
- `hook=off`). With the hook on, the board asks the hook director for the
910
- opening: one text call on the member's model key, which the price names among
911
- what it leaves out. `headline` is the text card at the start: `none`, or the
912
- member's own words for it (one short line; a refusal says what fits).
913
- With each sheet, show its price: `exodus video swipe sheet price <swipeId>`
914
- (free) prints it at the sheet's rows, with the most it can cost and one line
915
- of what it leaves out. A 480p draft or the first take only is a row the
916
- member sets (`size=480p`, `takes=first`) when the price lists them; read the
917
- price again after a set. The first take only is a cheap check of the method
918
- and the size, not of the final person: the whole video after it is a second
919
- start, paid on its own (`takes=all`, then `swipe start <swipeId> --again`),
920
- and it casts the person and draws the pictures again. Say so before that yes.
986
+ and do not work around it. A sheet with no `basedOn` row has no such choice
987
+ for this swipe: say so, and keep `who`. `filmed`, `pose`, `prop`, `moves`,
988
+ `place`, `look`, `time`, `placeNote` (how and where it is filmed), `hook`
989
+ (take 1's opening action, `off` or a level from 1 to 5, 2 the usual) and
990
+ `hookKind` (its kind, `any` or one the row lists) each carry their default's
991
+ reason: set one only when the member asks (`time=dusk`, `hook=3`). `notes` end
992
+ every take's prompt. With the hook on, the board asks the hook director for
993
+ the opening: one text call on the member's model key, which the price names
994
+ among what it leaves out. `headline` is the text card at the start: `none`, or
995
+ the member's own words for it (one short line; a refusal says what fits). The
996
+ screen's price is `exodus video swipe sheet price <swipeId>` (free) at the
997
+ sheet's rows, with the most it can cost; the option's description ends with
998
+ what it leaves out, shortened (the table's "Film it?" row). "why" gives each
999
+ line of the price. A 480p draft or the first take only is a row the member
1000
+ sets (`size=480p`, `takes=first`) when the price lists them; read the price
1001
+ again after a set. The first take only is a cheap check of the method and the
1002
+ size, not of the final person: the whole video after it is a second start,
1003
+ paid on its own (`takes=all`, then `swipe start <swipeId> --again`), and it
1004
+ casts the person and draws the pictures again. Say so before that yes.
921
1005
  **A money limit.** When the member gave one ("keep the whole thing under
922
1006
  $15"), hold it before the start: add the people's most when the dry write
923
1007
  printed one (its "At most $… in all"), what the write cost when the limit is
@@ -927,18 +1011,18 @@ price leaves out are in no figure: say so, and leave room for them. Over it,
927
1011
  nothing starts. When a smaller size the price lists fits (its whole video,
928
1012
  every take, and the start does not refuse it), set it before you show the
929
1013
  saved sheets (`exodus video swipe sheet set <swipeId> size=480p`, free), read
930
- the price again, and say on the sheet in one line that it is a 480p draft,
931
- the size that fits their limit: their yes to that sheet is the yes to it. A
932
- limit given after they saw the sheets: name the 480p draft and wait for their
933
- yes. With a money limit and no "at most" printed, the limit cannot be
934
- checked: stop and ask. For example, with a limit for everything:
935
- when the write's cost, the people's most and 720p's "at most" add up to more
936
- than the limit, and the same sum with 480p's "at most" is under it, set
937
- 480p. Every figure in that sum is the one the CLI printed for this swipe,
938
- never one from memory. When no size fits, stop and ask; when the price lists the first take
939
- only (`takes=first`), you may name it as a smaller thing they can choose,
940
- never as the whole video. The `--max-usd` you start with is the "at most" the
941
- price shows, so it is never above what is left of the member's limit.
1014
+ the price again, and say on the sheet in one line that it is a 480p draft, the
1015
+ size that fits their limit: their yes to that sheet is the yes to it. A limit
1016
+ given after they saw the sheets: name the 480p draft and wait for their yes.
1017
+ With a money limit and no "at most" printed, the limit cannot be checked: stop
1018
+ and ask. For example, with a limit for everything: when the write's cost, the
1019
+ people's most and 720p's "at most" add up to more than the limit, and the same
1020
+ sum with 480p's "at most" is under it, set 480p. Every figure in that sum is
1021
+ the one the CLI printed for this swipe, never one from memory. When no size
1022
+ fits, stop and ask; when the price lists the first take only (`takes=first`),
1023
+ you may name it as a smaller thing they can choose, never as the whole video.
1024
+ The `--max-usd` you start with is the "at most" the price shows, so it is
1025
+ never above what is left of the member's limit.
942
1026
 
943
1027
  **A video that reached its estimate.** A regular video (not One-take) keeps
944
1028
  the estimate it showed before the start. When its next take would cost more
@@ -958,29 +1042,27 @@ A write that carried the people's most makes the first people to pick from
958
1042
  (People, step 3). Offer more people, or voices to pick from, only when the
959
1043
  member asks for options. More people are paid on the member's keys: run
960
1044
  `exodus video swipe sheet people <swipeId> --count <n>` first (no `--yes`),
961
- show the price it prints word for word, and after their yes run the line it
962
- prints (`--yes --max-usd <n>`, the most the price said). Do not add `--wait`:
963
- it can wait up to 45 minutes. Read the sheet a few minutes later (`exodus
964
- video swipe sheet <swipeId>`) and show each person's name and picture address.
965
- A sheet with a `voice` row (there only while the server offers people and
966
- voices to pick from) has its voices listed once by the server after the write
967
- (when the member has an ElevenLabs key), and the row may recommend one
968
- and say why: a voice that fits the person, which may skip a voice the
969
- brand's recent swipes already have, so its videos don't all sound the same.
970
- A sheet with no `voice` row has no voices to pick from: say nothing about
971
- them. `exodus
972
- video swipe sheet voices <swipeId>` lists them again: one read of the voice
973
- list on the member's ElevenLabs key, and no speech is made, so it buys
974
- nothing. It prints the voices that fit the person, best fit first, each with
975
- its age and accent when known ("Sarah · young · American") and a sample to
976
- hear, then "Recommended: <n> (…). <why> A start with no pick films it."; after
977
- the member's pick, "Recommended: <n> (…). You picked it, so a start films it."
978
- or "… You picked <m>, so a start films your pick."; or why none is. A voice
979
- row with no voice prints "List the voices: exodus video swipe sheet voices
980
- <swipeId>". A
981
- pick is a set (`who=<n>`, `voice=<n>`), and the video is filmed with that
982
- person, their face and that voice. If the server says these choices are not
983
- switched on yet, say so and go on with the sheet as it is.
1045
+ put the price it prints in the option, and after the yes run the line it
1046
+ prints (`--yes --max-usd <n>`, the most the price said). Do not add
1047
+ `--wait`: it can wait up to 45 minutes. Read the sheet a few minutes later and
1048
+ show each person's name and picture address. A sheet with a `voice` row
1049
+ (there only while the server offers people and voices to pick from) has its
1050
+ voices listed once by the server after the write (when the member has an
1051
+ ElevenLabs key), and the row may recommend one and say why: a voice that fits
1052
+ the person, which may skip a voice the brand's recent swipes already have, so
1053
+ its videos don't all sound the same. A sheet with no `voice` row has no voices to pick from: say nothing
1054
+ about them. `exodus video swipe sheet voices <swipeId>` lists them again: one
1055
+ read of the voice list on the member's ElevenLabs key, and no speech is made,
1056
+ so it buys nothing. It prints the voices that fit the person, best fit first,
1057
+ each with its age and accent when known ("Sarah · young · American") and a
1058
+ sample to hear, then "Recommended: <n> (…). <why> A start with no pick films
1059
+ it."; after the member's pick, "Recommended: <n> (…). You picked it, so a
1060
+ start films it." or "… You picked <m>, so a start films your pick."; or why
1061
+ none is. A voice row with no voice prints "List the voices: exodus video swipe
1062
+ sheet voices <swipeId>". A pick is a set (`who=<n>`, `voice=<n>`), and the
1063
+ video is filmed with that person, their face and that voice. If the server
1064
+ says these choices are not switched on yet, say so and go on with the sheet as
1065
+ it is.
984
1066
 
985
1067
  For each video, in the listed order, run steps 1 and 2; step 3 comes once
986
1068
  every video has started:
@@ -988,78 +1070,84 @@ every video has started:
988
1070
  1. `exodus video swipe write <breakdownId> --product <id> --mode whole-ad
989
1071
  --closeness <n> --yes`. A mode set from a note changes the line:
990
1072
  `hook-only` takes `--closeness` as `whole-ad` does. `their-format` takes
991
- the member's own script: save it to a file and pass `--script <file>`,
992
- with no `--closeness` (the CLI refuses one). `new-look` takes `--look
993
- <slug>`; no command lists the looks a swipe can take, so ask the member
994
- for the exact look name and never invent one (the writer refuses a look
995
- it does not make). When step 5 applies, its write line takes the place of
996
- this one. The write takes four to nine minutes. Show the member the
997
- script, the direction, Kept and Changed, and what it cost. When a persona
998
- or a mechanism was picked and step 5 does not apply, add one line: "The
999
- persona and the mechanism are noted, not used: the video writer does not
1000
- read them yet."
1001
- For a kind whose write makes people (People, step 3), run the yes line
1002
- the dry write printed: `--yes --people-max-usd <most>`, or `--yes
1003
- --no-people` when the member wants none. A plain `--yes` makes no people,
1004
- and the write then says so: "No people to pick from were made with this
1005
- write: its yes carried no --people-max-usd. See their price (free): …".
1006
- With the figure, the write waits for the people (a line ending "Waiting for
1007
- them, up to 5 minutes."), then prints how their ask ended and each person
1008
- with their picture's address. The animal, when the script puts one in the
1009
- picture, is on the saved sheet's row "The animal" a few minutes later
1010
- (`exodus video swipe sheet <swipeId>` shows it with its picture's address);
1011
- a start waits for it while it is still being made. Show each person's name and picture. Read the
1012
- write's own lines; never assume one is recommended. When the ask names one
1013
- ("Person N is recommended." and why), the write says "A start with no pick
1014
- films person N, the recommended one." When it names none, it says "… films
1015
- a new person cast from …, not one of these. To film one of them (free):
1016
- exodus video swipe sheet set <swipeId> who=<n>": tell the member that a
1017
- start with no pick films none of the people shown, and set `who=<n>` only
1018
- on their word. When none were made, it prints the server's sentence for
1019
- that (it says why when the server knows, as for a script that keeps no type
1020
- of their speaker) or "No people were made with this write, and nothing was
1021
- paid for them.", then "Ask for them (the price first, free): exodus video
1022
- swipe sheet people <swipeId>". After 5 minutes it prints "Still not done
1023
- after 5 minutes: …" with what the server last said, then "See them: exodus
1024
- video swipe sheet <swipeId>" (when the server said nothing: "The people are
1025
- still being made. See them: …"): the write is done, so read the sheet a few
1026
- minutes later.
1027
- For a kind whose sheet has these rows (One-take UGC today), the write may
1028
- also write our own text card and pick a kind of opening. They show on the
1029
- saved sheet as `headline` and `hookKind`, marked recommended. When one was
1030
- left out, Changed ends with a note. "We left out the text card we wrote:
1031
- <why>. The video has no text card.": tell the member in one line; they may
1032
- write their own card (`headline="<words>"`) or leave the video with none.
1033
- "We left out the kind of opening we picked: <why>. The sheet's kind of
1034
- opening row keeps its default.": tell the member; they may set `hookKind`
1035
- to a kind the row lists, or leave the default.
1036
- The write's last line says "Start the video (paid; ask first)": the
1037
- sheet's yes was that ask, so start now, with the line below, not the
1038
- write's own, which leaves out `--one-shot`. For a kind with a saved
1039
- sheet, that ask is the saved sheet's yes instead: start after it. Note the
1040
- swipe id it printed for that video.
1041
- 2. `exodus video swipe start <swipeId> --one-shot --yes`, without
1042
- `--one-shot` when the member chose to stop at the storyboard, and with
1043
- `--music` when they chose music. For a kind with a saved sheet whose price
1044
- printed a number, add `--max-usd <n>` with the "at most" it showed: a
1045
- start that can now cost more is refused, and nothing is started. With a
1046
- money limit, start only once that "at most" fits what is left of it ("A
1047
- money limit", above). No
1048
- number printed: no `--max-usd`, and never a guessed one. When the sheet
1049
- has people, the start says first whom it films ("A start with no pick
1050
- films person N, the recommended one.", or the member's pick). While they
1051
- are still being made it says "People to pick from are being made for this
1052
- swipe. The start waits for them, …", waits until 5 minutes after they
1053
- were asked for, then starts and says whom it films. Give the member the
1054
- `Watch it:` link at once. Then go on to the next video.
1055
- 3. When every video has started, follow each run with `exodus video status
1056
- <runId>` and do what it prints. The app makes a swiped video's cut ("End:
1057
- watch and approve"), so make no cut of your own. A one-shot run is
1058
- delivered by itself once that cut is made: give the member its run page.
1059
- While the app makes it, `status` says "Every piece is made. The app makes
1060
- the cut now; look again in a minute: exodus video status <runId>": read
1061
- `status` again in a minute. A run that stopped at the storyboard goes to
1062
- stop 3, then the end.
1073
+ the member's own script: save it to a file and pass `--script <file>`, with
1074
+ no `--closeness` (the CLI refuses one). `new-look` takes `--look <slug>`;
1075
+ no command lists the looks a swipe can take, so ask the member for the
1076
+ exact look name and never invent one (the writer refuses a look it does not
1077
+ make). When step 5 applies, its write line takes the place of this one. The
1078
+ write takes four to nine minutes: say so in one line. When it is done, one
1079
+ line: the script's opening and what it cost ("show script" gives the
1080
+ script, the direction, Kept and Changed). When the member picked a persona
1081
+ or a mechanism and step 5 does not apply, add one line: "The persona and
1082
+ the mechanism are noted, not used: the video writer does not read them
1083
+ yet." For a kind whose write makes people (People, step 3), run the yes
1084
+ line the dry write printed (`--yes --people-max-usd <most>`), or `--yes
1085
+ --no-people` when the member wants none; a plain `--yes` makes none, and
1086
+ says so. With the figure, the write waits up to 5 minutes for the people,
1087
+ then prints each with their picture's address and whom a start with no pick
1088
+ films: the one it recommends, or a new person cast from their speaker's
1089
+ type, not one of these (tell the member; set `who=<n>` only on their word;
1090
+ never assume one is recommended). When none were made it says so, that
1091
+ nothing was paid for them, and how to ask for them (the price first, free).
1092
+ After the 5 minutes the write is done: read the sheet a few minutes later.
1093
+ The animal, when the script has one, is on the saved sheet's row "The
1094
+ animal" a few minutes later, with its picture's address; a start waits for
1095
+ it. For One-take UGC the write may also write our own text card and pick a
1096
+ kind of opening (`headline`, `hookKind`, marked recommended); when Changed
1097
+ ends "We left out the text card we wrote: …" or "We left out the kind of
1098
+ opening we picked: …", tell the member in one line: they may write their
1099
+ own card (`headline="<words>"`), set `hookKind` to a kind the row lists, or
1100
+ leave it. The write's last line says "Start the video (paid; ask first)":
1101
+ the sheet's yes was that ask, so start now, with the line below, not the
1102
+ write's own, which leaves out `--one-shot`. For a kind with a saved sheet,
1103
+ that ask is the saved sheet's yes instead: start after it. Note the swipe
1104
+ id it printed for that video.
1105
+ 2. `exodus video swipe start <swipeId> --one-shot --yes`, without `--one-shot`
1106
+ when the member chose to stop at the storyboard, and with `--music` when
1107
+ they chose music. For a kind with a saved sheet whose price printed a
1108
+ number, add `--max-usd <n>` with the "at most" it showed: a start that can
1109
+ now cost more is refused, and nothing is started. With a money limit, start
1110
+ only once that "at most" fits what is left of it ("A money limit", above).
1111
+ No number printed: no `--max-usd`, and never a guessed one. When the sheet
1112
+ has people, the start says first whom it films. Give the member the `Watch
1113
+ it:` link in one line, at once. Then go on to the next video.
1114
+ 3. When every video has started, wait on each run in the background with
1115
+ `exodus video wait <runId>`, each in its own command, and say one line:
1116
+ "Filming <n> videos · I'll tell you when each is delivered or needs you."
1117
+ When a wait ends, read `exodus video status <runId>` once and do what it
1118
+ prints. The app makes a swiped video's cut ("End: watch and approve"), so
1119
+ make no cut of your own. A run that stopped at the storyboard goes to stop
1120
+ 3, then the end, which asks the final approve. A one-shot video is
1121
+ delivered by itself once the app's cut is made, with no final approve,
1122
+ unless the film's check against its own sound fails ("End: watch and
1123
+ approve").
1124
+
1125
+ **A stop that needs the member** (a check found a problem, a held take, a
1126
+ refused write or start) is two lines and a question, offering only the ways
1127
+ that `status`, the hold's own sentence or the refusal names: the free look
1128
+ first, a free way marked "free", a paid way with the price the CLI printed for
1129
+ it (`sheet price` before a new run with `--again`) or "no printed price". A
1130
+ new run keeps none of the first start's flags: give `--one-shot` and `--music`
1131
+ again when the first had them. Its message, as text first (rule 2):
1132
+
1133
+ > Stopped for you. <each cost line the stopped step printed, as printed, if any: "It cost $<X> on the member's key."> Say "why"
1134
+
1135
+ Its question (`AskUserQuestion`, header "What now?"), its text:
1136
+
1137
+ > <what happened, in plain words>. <what is still good>.
1138
+ > Spent $<X> of about $<Y> (or rule 5's other forms). What now?
1139
+
1140
+ Its options: 1. the free look ("Watch take 2 first") 2. a free way on ("Keep
1141
+ it · free") 3. a paid way on, as the table's "A hold" or "A refused write" row.
1142
+
1143
+ **Delivered** is three lines, the money line last:
1144
+
1145
+ > Done. <the run page, or the file `pull` wrote>.
1146
+ > Listen once: <a word `status` flags, or the product's name>.
1147
+ > Spent $<X> of about $<Y> for the film (or rule 5's other forms); before it, <the last money line's figures, each with whose keys>
1148
+
1149
+ With several videos, one line a video: its ad and persona, its `Watch it:`
1150
+ link and its money, or why it stopped.
1063
1151
 
1064
1152
  **Never start the same swipe twice.** One swipe is one video. A start of a
1065
1153
  swipe that already has a video is refused, starts nothing, and names the run:
@@ -1074,55 +1162,36 @@ noted none), with no run and not marked refused, is that write. Show it with
1074
1162
  row marked refused is that write's refusal: report it as a refused write. When
1075
1163
  no such row is there yet, the write may still finish: check again later.
1076
1164
 
1077
- At the end, report each video on one line: its ad and persona, its run id
1078
- and its `Watch it:` link, or why it stopped. For a One-take video, add what it
1079
- cost (the "Cost:" line of `status`), beside the "about" shown before the
1080
- yes.
1081
-
1082
- **The end of each video** is as "End: watch and approve" says. A one-shot
1083
- video is delivered by itself once the app's cut is made, with no final
1084
- approve, unless the film's check against its own sound fails ("End: watch and
1085
- approve"). A video that stopped at the storyboard asks the final approve, which
1086
- is one way. A redo of a clip there needs its own yes.
1087
-
1088
1165
  **A refusal or a failed check stops that video only.** The others go on, and
1089
1166
  every video is in the report at the end. A refused write prints "The writer
1090
1167
  refused:" and its sentence (on an admin key, then "What the checks found:"),
1091
1168
  its swipe id, what it cost, "Nothing was started." and "Writing again is paid
1092
1169
  too: the same exodus video swipe write line, after the member's yes.". Report
1093
- all of it for that video.
1094
-
1095
- A refusal for claims reads "Your product sheet doesn't back up …" and names
1096
- up to two held lines, each with why in brackets: `it says "…", which we
1097
- couldn't find on the sheet`; `… which the sheet says, but we couldn't find it
1098
- in the part we matched to this claim`; `we found no one sentence of the sheet
1099
- that backs "…" as the line says it`; `it still hedges or repeats a word of
1100
- "…", the claim we rewrote it from`; `it names the product next to a line we
1101
- took out, so it reads as that line's claim`; or, for a shot, `it shows a
1102
- result, "…", in so many words, and we never back a shot that does, whatever
1103
- the sheet says`. More lines end "and N more (the dashboard lists every one)".
1104
- Give the member the way out the refusal ends with:
1105
-
1106
- - When it ends "If it's true, add the line's own words to your product's
1107
- description (on the dashboard: Library, Materials, Brand info, then the
1108
- product's Edit), then write again." (or "If a line is true, …", or "If a
1109
- spoken line whose claim we couldn't find on the sheet is true, …"): ask
1110
- the member whether that line is true of their product. Only if it is, they
1111
- add the line's own words to the product's description at that place. Then,
1112
- on their yes, run the same write line again.
1113
- - When it ends "Write again." alone, no held line can be backed by the
1114
- description: on the member's yes, run the same write line again.
1115
- - "… a price or code your product sheet doesn't list. If it's right, add it
1116
- to your product's description (…), then write again.": the same, for that
1117
- price or code.
1170
+ it as a stop that needs the member (above), with the ways on its sentence ends
1171
+ with.
1172
+
1173
+ A refusal for claims reads "Your product sheet doesn't back up …" and names up
1174
+ to two held lines, each with why in brackets (not found on the sheet, a hedge
1175
+ kept, the product named next to a line taken out, a shot that shows a result);
1176
+ more end "and N more (the dashboard lists every one)". The ways on, by how it
1177
+ ends:
1178
+
1179
+ - "If it's true, add the line's own words to your product's description (on
1180
+ the dashboard: Library, Materials, Brand info, then the product's Edit),
1181
+ then write again." (or "If a line is true, …", "If a spoken line whose claim
1182
+ we couldn't find on the sheet is true, …", or the same for "a price or code
1183
+ your product sheet doesn't list"): ask the member whether it is true of
1184
+ their product. Only if it is, they add its own words there; then, on their
1185
+ yes, run the same write line again.
1186
+ - "Write again." alone: no held line can be backed by the description: on the
1187
+ member's yes, run the same write line again.
1118
1188
  - "The script we wrote left out …, and at closeness … every beat stays. …":
1119
1189
  the member adds what that beat can say to the product's description, or
1120
- picks closeness 4 or 5, where beats can merge or drop. Then write again on
1190
+ picks closeness 4 or 5, where beats can merge or drop; then write again on
1121
1191
  their yes.
1122
1192
  - "Your script says "…", from their ad or a price or code your product sheet
1123
1193
  doesn't list. We never change your words, so take it out, then try again.":
1124
- the member's own script holds those words. They take them out of the file,
1125
- and you write again on their yes.
1194
+ they take those words out of their own script; write again on their yes.
1126
1195
  - Any other sentence: say it as it is, and write again only on their yes.
1127
1196
 
1128
1197
  **Never write around a refusal yourself.** Do not pass the refused script,
@@ -1173,16 +1242,19 @@ mechanism noted only.
1173
1242
 
1174
1243
  **On the sheet, when the path is open.**
1175
1244
 
1176
- - Rows 1 and 2 read "(used through the text swipe bot)" in place of
1177
- "(noted; …)".
1178
- - Row 3 reads "1 Near-clone, 2 New scene, same beats, 3 Same idea, new
1179
- drama, 4 Same arc, 5 Pattern only (with 4 or 5, the persona and the
1180
- mechanism are only noted)". Levels 1 to 3 are the `swipe` skill's levels
1181
- (its section 2), not the dial's: say so when the member asks. A video the
1182
- bot does not write takes the same number as its `--closeness`.
1183
- - **It buys** adds, when the picks give the bot any video: "and a text swipe
1184
- call for each video (two at level 2 or 3), on your own Genesis and model
1185
- keys." When only some videos take it, name them ("for videos 1 and 3").
1245
+ - On "show sheet" and in "Change something", rows 1 and 2 read "(used through
1246
+ the text swipe bot)" in place of "(noted; …)".
1247
+ - On "show sheet" and in "Change something", row 3 reads "1 Near-clone, 2 New
1248
+ scene, same beats, 3 Same idea, new drama, 4 Same arc, 5 Pattern only (with
1249
+ 4 or 5, the persona and the mechanism are only noted)". Levels 1 to 3 are
1250
+ the `swipe` skill's levels (its section 2), not the dial's: say so when the
1251
+ member asks. A video the bot does not write takes the same number as its
1252
+ `--closeness`.
1253
+ - The spending option's description adds, when the picks give the bot any
1254
+ video: "Plus a text swipe call for each video (two at level 2 or 3), on your
1255
+ own Genesis and model keys, no printed price." When only some videos take
1256
+ it, name them ("for videos 1 and 3"). **It buys** on "show sheet" says the
1257
+ same.
1186
1258
  - A reply that adds bot calls makes the buy bigger, so it is not the yes: a
1187
1259
  persona or a mechanism added where the sheet had none, or, while a persona
1188
1260
  or a mechanism is picked, how close moved from 1 to 2 or 3, or from 4 or 5
@@ -1253,19 +1325,19 @@ say; a result beyond them needs a product fact.
1253
1325
  "the #1").
1254
1326
 
1255
1327
  When a picked persona or mechanism is missing, or a line promises something
1256
- the product's facts do not hold (a result, a health benefit, a number), do
1257
- not start that video: show the member that line and ask. The other videos go
1258
- on. Show each such line with the fact it would need, and offer three ways
1259
- on: start it as written, leave that video out, or the member's own words for
1260
- those lines, written again with `--mode their-format --script <file>` (a
1261
- second paid write, on their word) and checked again. This is the one stop
1262
- this path adds, and it comes only when the check finds something. The write
1263
- may still refuse a name, price or code from their ad, or a cast the kind of
1264
- ad cannot take (more speakers than it holds, or speakers where it takes a
1265
- narrator only): a refused write stops that video only, as above. A write
1266
- whose wait was cut off and is found again with `exodus video swipe show
1267
- <swipeId>` (as "On the yes" says) gets this check too, on the script `show`
1268
- prints, before its start.
1328
+ the product's facts do not hold (a result, a health benefit, a number), do not
1329
+ start that video: show the member that line and ask. The other videos go on.
1330
+ Show each such line with the fact it would need, and offer three ways on:
1331
+ start it as written, leave that video out, or the member's own words for those
1332
+ lines, written again with `--mode their-format --script <file>` (a second paid
1333
+ write, on their word) and checked again. Ask it as step 4's stop that needs
1334
+ the member. This is the one stop this path adds, and it comes only when the
1335
+ check finds something. The write may still refuse a name, price or code from
1336
+ their ad, or a cast the kind of ad cannot take (more speakers than it holds,
1337
+ or speakers where it takes a narrator only): a refused write stops that video
1338
+ only, as above. A write whose wait was cut off and is found again with `exodus
1339
+ video swipe show <swipeId>` (as "On the yes" says) gets this check too, on the
1340
+ script `show` prints, before its start.
1269
1341
 
1270
1342
  **Run so far.** Levels 1 and 2 of this path have been run for real, as far
1271
1343
  as the write. Level 3 has not.
@@ -1291,83 +1363,42 @@ noted only.
1291
1363
 
1292
1364
  ### Step by step: a yes before each paid step
1293
1365
 
1294
- For a member who asks for stops. Four steps cost money, and the CLI prints no
1295
- price for any of them but the people a write makes and the start of a kind
1296
- with a saved sheet. Run each one first without `--yes`: it sends nothing and
1297
- prints what the step buys and who pays. Tell the member both, and the price
1298
- when it prints one, else say the CLI prints no price; never guess one, and run
1299
- the same line with `--yes` only after their yes.
1300
-
1301
- 1. **Get the ad.** One of a video file, a link (Meta Ad Library, TikTok,
1302
- Instagram or YouTube), or a video ad in the brand's swipe library by the
1303
- id that `exodus video swipe find` prints (free):
1304
- `exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId>`.
1305
- The breakdown is paid on the team's keys, not the member's. A link or an
1306
- ad this brand broke down before comes back at once and costs nothing.
1307
- With `--wait` it prints each step as it starts, and takes a few minutes.
1308
- Once it is done, `exodus video swipe status <breakdownId> --full` prints
1309
- what Exodus read from the ad: each shot with its cut times, a-roll or
1310
- cutaway, framing, camera and description, then the script with who says
1311
- each line, then the cast, then how it is filmed. It is free. Show the
1312
- member the shot list and the script before the template, so they can say
1313
- whether Exodus read their ad right. In "How it is filmed", every line but
1314
- Measured, Cuts and Words is the video model's reading by eye, and it is
1315
- often wrong: in Exodus's own checks the camera height was right 2 times
1316
- in 9. Cuts is counted, but it includes jump cuts the video model saw.
1317
- Give the by-eye lines as what Exodus thinks it saw, never as fact, and
1318
- ask the member to check any that matters against the ad. Measured says
1319
- only that most of the part of the frame it could read stood still; it
1320
- does not prove the phone was put down.
1321
- 2. **The template.** `exodus video swipe template <breakdownId>`, paid on the
1322
- member's own Anthropic or OpenRouter key. It prints the kind of ad and the
1323
- look the ad matched, and why. A template made before costs nothing. Show
1324
- the member the kind and the look, and the "Also fits their ad: …" line when
1325
- it prints one (the One-take UGC row under "3. The sheet, once" says what to
1326
- do with it). The swipe writes the kind it was matched to, or the one the
1327
- write names with `--kind`, and no other: name another kind only on the
1328
- member's yes. A kind this ad can't be made as is refused before the write
1329
- is paid, with the kinds it can be made as. For any other kind, stop here
1330
- and make the video from that format with the ad's words instead ("From one
1331
- sentence to a film").
1332
- 3. **The choices.** `exodus video swipe products` lists the brand's
1333
- products. Ask which product, what to swipe and how close. What to swipe
1334
- (`--mode`, `whole-ad` if left off): Whole ad, Hook only, Their format, my
1335
- script (`--script <file>`, the member's own words), or Their script, a new
1336
- look (`--look <slug>`). How close (`--closeness`, 2 if left off): 1 Mirror,
1337
- 2 Close, 3 Same beats, 4 Same arc, 5 Pattern only. `exodus video --help`
1338
- has each one's line.
1339
- 4. **The write.** `exodus video swipe write <breakdownId> --product <id>
1340
- [--mode …] [--closeness …]`, paid on the member's own key. It takes four to
1341
- nine minutes and waits by itself. Show the member the script, the
1342
- direction, Kept and Changed, and what it cost. When the line without
1343
- `--yes` also prints the people's price (One-take UGC, when the server
1344
- offers people), it prints the yes line with `--people-max-usd <most>`: tell
1345
- the member that price, and run that line on their yes, or `--yes
1346
- --no-people` when they want none. When it prints none, the write makes no
1347
- people. With people, the write then waits up to 5 minutes more for the people and
1348
- shows them, as step 1 of "On the yes" says. A refusal prints the writer's
1349
- sentence and "Nothing was started.": tell the member, give them the way out
1350
- the sentence ends with ("A refusal or a failed check" in "On the yes"), and
1351
- write again, which is paid too, only on their yes. If the wait gives up,
1352
- the write may still finish: run `exodus video swipe list` before writing
1353
- again. It shows the brand's newest swipes, and a refused one is marked with
1354
- what it cost.
1355
- 5. **The start.** `exodus video swipe start <swipeId>`. It buys the
1356
- storyboard and its pictures; the voices and clips wait for the storyboard's
1357
- yes. `--style <look>` changes the look, `--music` adds a music bed.
1358
- `--title "<name>"` names the ad, for admins only: a beta tester leaves it
1359
- off, or the CLI refuses it with one sentence naming it. With `--one-shot`
1360
- it buys the whole video with no stop: ask before passing it. `--wait` waits until the run needs the
1361
- member. A swipe that already has a video is refused, with its run; a
1362
- second video from it needs `--again` and the member's yes to a second video.
1363
- For a kind with a saved sheet (One-take UGC today), show the saved sheet
1364
- one time before this start, as in step 4 (`exodus video swipe sheet
1365
- <swipeId>`, free), in the same message as what the start buys and who
1366
- pays (the line without `--yes`). On this path the saved sheet's yes is
1367
- the start's yes: ask once, then run the line with `--yes` and the
1368
- `--max-usd <n>` that line printed (its price's "at most"): a start that
1369
- can now cost more is refused, and nothing is started. A reply that
1370
- only changes a row is not that yes.
1366
+ For a member who asks for stops: the steps above, with one question before
1367
+ each of the four paid steps (the read of an ad, its template, the write, the
1368
+ start) in place of one yes for all. Run each one first without `--yes` (it
1369
+ sends nothing), put what it prints in the option (the table's "Step by step"
1370
+ row), and run the same line with `--yes` only after their yes.
1371
+
1372
+ 1. **Get the ad.** Step 1's breakdown line for one ad, first without `--yes`,
1373
+ then asked ("without asking" does not hold here): a video file, a link
1374
+ (Meta Ad Library, TikTok, Instagram or YouTube), or a video ad in the
1375
+ brand's swipe library by the id that `exodus video swipe find` prints
1376
+ (free). Then show the shot list and the script (`status --full`, free), so
1377
+ the member can say whether Exodus read their ad right. In "How it is
1378
+ filmed", every line but Measured, Cuts and Words is the video model's
1379
+ reading by eye, often wrong (the camera height was right 2 times in 9 in
1380
+ Exodus's checks): say those as what Exodus thinks it saw. Cuts counts jump
1381
+ cuts the model saw too; Measured does not prove the phone was put down.
1382
+ 2. **The template.** Step 1's template line, first without `--yes`, then
1383
+ asked. Show the kind, the look, why, and the "Also fits their ad: …" line
1384
+ when it prints one (the One-take UGC row of step 3). The swipe writes the
1385
+ kind it was matched to, or another named with `--kind` on the member's yes.
1386
+ For a kind this ad can't be made as (step 3's "The kind of ad"), stop here
1387
+ and make the video from that format with the ad's words ("From one sentence
1388
+ to a film").
1389
+ 3. **The choices**, as questions: the product, what to swipe (`--mode`, as
1390
+ step 4's write line says) and how close (`--closeness`, 2 if left off).
1391
+ 4. **The write.** Step 4's write line: its people's price goes in the option
1392
+ when the line without `--yes` prints one, and their yes line is the one it
1393
+ prints.
1394
+ 5. **The start.** `exodus video swipe start <swipeId>` buys the storyboard and
1395
+ its pictures; the voices and clips wait for the storyboard's yes. With
1396
+ `--one-shot` it buys the whole video with no stop: ask before passing it.
1397
+ `--style <look>` changes the look, `--music` adds a music bed, and `--wait`
1398
+ waits until the run needs the member. `--title "<name>"` names the ad, for
1399
+ admins only: a beta tester leaves it off, or the CLI refuses it with one
1400
+ sentence naming it. For a kind with a saved sheet, its question (step 4) is
1401
+ the start's question, with the `--max-usd <n>` the line printed.
1371
1402
  6. **Then** stop 3 (the storyboard) and the end, as above.
1372
1403
 
1373
1404
  ### Every swipe command
@@ -1375,32 +1406,23 @@ the same line with `--yes` only after their yes.
1375
1406
  ```operator-guide
1376
1407
  exodus video swipe --file <ad.mp4> | --url <link> | --ad <swipeAdId> [--yes] [--wait]
1377
1408
  break the ad down (team's keys); one read before costs nothing
1378
- exodus video swipe status <breakdownId> [--wait] [--full] where the breakdown stands, step by step;
1379
- --full adds what it read: shots, script, cast, filming
1409
+ exodus video swipe status <breakdownId> [--wait] [--full] where the breakdown stands; --full: shots, script, cast, filming
1380
1410
  exodus video swipe template <breakdownId> [--yes] the kind of ad and look it matched (member's key)
1381
1411
  exodus video swipe products the brand's products and their ids
1382
1412
  exodus video swipe write <breakdownId> --product <id> [--mode <mode>] [--closeness <step>] [--look <slug>] [--script <file>] [--kind <kind>] [--yes [--people-max-usd <n>]] [--no-people]
1383
- the brand's version (member's key); waits for it. For a kind
1384
- whose write makes people (when the server offers them),
1385
- without --yes it also prints their price, and --yes
1386
- --people-max-usd <n> makes them too
1413
+ the brand's version (member's key); without --yes, its people's price
1387
1414
  exodus video swipe show <swipeId> one swipe again
1388
- exodus video swipe list the brand's newest swipes, each with when it was written and its product;
1389
- a refused one shows what it cost
1415
+ exodus video swipe list the brand's newest swipes, when written, product, a refusal's cost
1390
1416
  exodus video swipe find [--brand "<name>"] [--limit <n>] video ads in the swipe library to offer as options (free); no kind, no results
1391
1417
  exodus video swipe start <swipeId> [--style <look>] [--title "<name>"] [--music] [--one-shot] [--again] [--max-usd <n>] [--yes] [--wait]
1392
- start the run on the kind the swipe wrote; --again for a
1393
- second, paid video of a swipe that already has one; waits
1394
- up to 5 minutes for people still being made
1395
- exodus video swipe sheet <swipeId> the saved sheet the server keeps for a swipe (free);
1396
- no dashboard page shows it yet
1418
+ the run on the kind the swipe wrote; --again: a second, paid video
1419
+ exodus video swipe sheet <swipeId> the saved sheet the server keeps for a swipe (free)
1397
1420
  exodus video swipe sheet set <swipeId> <row>=<value> ... change rows of the saved sheet, all or none; <row>= clears one (free)
1398
1421
  exodus video swipe sheet set <swipeId> basedOn=look --yes --people-max-usd <n>
1399
1422
  their look: run it first without --yes for its price
1400
1423
  exodus video swipe sheet price <swipeId> the video's price at the saved sheet's rows and at each size and takes (free)
1401
1424
  exodus video swipe sheet people <swipeId> [--count <n>] [--yes --max-usd <n>]
1402
- new people to pick from (paid on the member's keys: the
1403
- price first, --yes with its most makes them); who=<n> picks one
1425
+ new people to pick from (member's keys; the price first); who=<n> picks one
1404
1426
  exodus video swipe sheet voices <swipeId> the voices that fit the person, best fit first, each with its
1405
1427
  sample (and its age and accent when known), and the one the
1406
1428
  row recommends, if any: one read of the voice list on the
@@ -1453,7 +1475,9 @@ CLI words it the way the run page does. On their own brands they can:
1453
1475
  - `video approve <runId>`: approves the storyboard. At an audition stop,
1454
1476
  `video approve <runId> --audition <digest>` accepts the audition clips, and
1455
1477
  plain `video approve <runId>` pays for another try of the failed audition
1456
- takes ("The audition stop"). Nothing else.
1478
+ takes ("The audition stop"). When their finished video waits for them
1479
+ ("finish it"), `video approve <runId>` finishes it, as "End: watch and
1480
+ approve" says. Nothing else.
1457
1481
  - `video voices <runId>`: who speaks, their current voice, and the voices on
1458
1482
  the tester's own ElevenLabs account. `--set <character>=<voiceId>` picks one,
1459
1483
  until the storyboard is approved.