Asking CODA to do something to a take#
Applies to v0.9Last reviewed
In short
Anything the controls under the picture can do, you can ask CODA to do in the chat. "This" means the take on the stage; CODA does some things straight away and puts others on a card for you to click.
Everything you can do with the controls under the picture, you can also ask CODA to do. Type it in the chat, in your own words, and CODA does what the button does.
"This" means the take on the stage#
When you say this, it or the take, CODA uses the take the Viewport is showing when you send the message. That is the one you picked, or the newest take if you have not picked one. CODA is told what that take is: its name, whether it is circled, withdrawn or erased, and which shot it is in. It is not shown the picture.
If nothing is on the stage and you have not said which take you mean, CODA asks. It never guesses, least of all about something like withdrawing.
You can also name a take in words. CODA searches this production only, by name, by title, or by what the prompt described:
Circle the dragon take.
Download v2.
v2 means version 2 of the take on the stage.
What CODA does straight away#
These cost nothing and can be undone, so CODA does them at once and tells you what it did:
| You say | CODA does |
|---|---|
| "Circle this", "take the star off" | ★ Circle, or uncircle |
| "Thumbs up", "thumbs down, it flickers" | 👍 or 👎, with the reasons you gave |
| "Call this 'The keeper'", "clear the title" | Renames the take |
| "Put this in shot 3" | Assign to shot |
| "Add this to Mara's pack" | Add to Bible |
| "Put this on the Moods board", "take it off the board" | Add to board, or remove |
| "Bring it back" | Restore a withdrawn take |
CODA's line in the chat says what was done. Where there is an obvious way back, the line has an Undo button: for the star, for a board, and for a rename.
Add to Bible changes the entry's reference pack, and a changed pack has to have its rights basis affirmed, by you, in the Bible tab. So when you ask CODA to add a picture to an entry, or to take pictures out of one or reorder them, it puts up a card showing the references before and after and what happens to the rights; nothing changes until you press the card's button. A reply like "I like it" is never taken as a yes. CODA can also make, rename and delete the Bible's entries and stage a rights draft for you to affirm; that is described in The production bible.
CODA can do up to three of these in one message. If you ask for more, it does three, tells you how many are left, and you say carry on.
What CODA puts on a card for you to click#
Some things cost money. For those, CODA prepares a card in the chat, and nothing happens until you click on it:
| You say | The card |
|---|---|
| "Give me variations of this" | Variations: the same recipe, a new seed |
| "Animate this" | Animate: the still as the first frame of a clip |
| "Edit this: make it night" | Edit, with the change you described |
| "Branch from this version" | Branch from here: the recipe as it stands |
| "Use this as a reference for a poster" | Use as reference, with your prompt |
Each card shows its price, and Generate on the card is the only click that spends. It is the same card the buttons make.
Settings you ask for go on the card. "Make it eight seconds", "four pictures", "square" or "use seed 7": CODA puts the setting on the card it prepares, and the price on the card is for that setting. A model only offers some settings (a clip's length, how many pictures, the picture's shape). If you ask for one the model does not offer, or a value outside what it takes, CODA says so and says what the model does take, and prepares no card until the request fits; nothing is spent either way.
A card that is waiting can be put away: Dismiss on a generation card or a run plan closes it. It spends nothing, and the card then reads Withdrawn · nothing was spent and cannot be approved. If you change the plan in the chat ("do the stills first, not the video"), CODA may close its own waiting card and says so; it never approves one. CODA is told which cards are waiting, so it can tell you what a card is for instead of guessing.
Whatever happens to a card, CODA's chat says so in one short line. Approve it and the chat says Making it now; I'll say when it's done. When the take ends you get Done: a still for Shot 1 ($0.03), now in History. (or Failed: with the reason, or Cancelled:). Dismiss a card and you get Dismissed the card for a still for Shot 1. Nothing was spent. Click an old card that was already withdrawn and you get The card for a still was withdrawn, so nothing was started or spent. These lines come from the app, not from CODA's model, so they appear even when CODA's follow-ups are switched off or you have used your day's allowance. CODA's own message after a take ends ("here is what I would do next") is extra: when it is skipped, the card says why, for example CODA's follow-up was skipped: the daily allowance was reached.
CODA remembers what became of its cards. Ask "what's pending?" or "what did I dismiss yesterday?" and CODA answers from the production's record of cards, from any conversation, not only the one you are in. Since 0.14.2 that record is in front of her every turn, so a vague question ("what did I leave open?", "what's on the table?") is answered from it too, with each card's kind, price and standing. When you open a new conversation in a production you have worked in before, CODA's first line says what changed since you were last here ("Since you were last here: 3 takes finished, 1 take failed. 2 cards are still waiting.").
If you have already said yes in your own words ("ok, approve it"), CODA no longer asks you to approve again or says it cannot: the card is yours to click, because the click is what spends.
Approving a card and dismissing it at the same moment (two tabs, a double click) cannot both succeed: whichever reaches the server first wins, and the other says so. A card that has already made a take cannot be dismissed, and a dismissed card makes nothing.
Some things need a card for other reasons:
- "Withdraw this" shows a confirmation card. Nothing is withdrawn until you click Withdraw on it. You can bring the take back later with Restore, or by telling CODA to.
- "Download this" shows a card with a Download button. Your browser only saves a file when you click, so CODA cannot save it for you. The button fetches the original file, the same one the Download control gives you.
- "Let me paint over the sky": you cannot paint a region in a chat, so CODA opens the editor on the stage for that take instead. Paint the region, say what it should become, and press Propose. That makes a card, and nothing is spent until you send it.
What CODA will not do#
CODA can do only what you could do yourself. If your account cannot change something in this workspace, it cannot change it through CODA either, and CODA tells you so. It only ever acts on takes in the production you are working in.
When CODA says it did something it did not#
CODA acts by sending a request, and what it tells you is checked against what it actually did. If CODA's message claims something was done ("I've renamed her", "I've created Sarah") but no action ran, Zymcos adds one line to the end of that message: Nothing was changed: I did not run that action. Trust that line; the Bible, your takes and your script are as they were. A sentence about something CODA did in an earlier message ("the outline I queued earlier") is about that message and is not held against this one, and an everyday verb said of the story or of a reason ("I shifted the story to an office", "the thing you edited was locked") is not a claim either. The same line appears when CODA says a picture or a run is waiting for your approval, or quotes what it will cost, but no card is in the chat: the price and the approval always come on a card, and nothing is spent until you click it. If CODA could not send its request properly at all, you see I could not carry that out, so nothing was changed. Please try again. instead of its words; if an earlier step of the same reply had already worked, it says instead I could not carry out the last step. The actions shown above did run. (and the one-line note on a claim reads I did not run that action; only the actions shown above did run.). A message CODA is correcting disappears from the chat as it is replaced. Say it again, a little more directly, and it will usually work. If you name someone who is not in your bible ("rename Sarah to Natalie"), CODA tells you she is not there and offers to make her; it does not change the entry you have selected.
Say what you want, in your own words#
You never need to learn Zymcos's words. "Start the clips with scene 1", "make that move", "delete that card" and "try that again" all work: CODA finds the picture you mean (a scene or a shot by its number), works out which control it is, and either does it or puts it on a card for you to click. She will not ask you to say or type a particular word such as "animate". If you ask for something she was refused earlier, she tries again and tells you what happens now, because whatever blocked it may have been done since.
On a clip's card, the first line says where it starts: Starts from the picture you chose. Only pictures you attached yourself (a style or a character, say) are listed as Carries … reference pictures you attached. A clip's description says what is in the frame and how it moves; it does not say what to leave out.
A yes answers what CODA last asked (0.14.2)#
When CODA asks a question or makes an offer ("shall I put up scene 3's clip card?") and you answer yes, she does that. A card that is already waiting is pressed on the screen; she never treats your yes to something else as a yes to it. If you ask for a waiting card again, or say you cannot find it, she gives you its link, and if you still want it in this conversation she withdraws the old card and puts up a fresh one.
She does not agree with something the record contradicts. If you say "we have the clip for this already" and the production shows no clip for that scene, she says what the record shows, kindly, in the same reply, and asks which is right. A card, her record of cards and her "Done" lines name the shot and its scene ("shot 5 (scene 2)").