# Asking CODA to do something to a take

> 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.

Applies to: v0.9 · Last reviewed: 2026-10-30 · Canonical: https://docs.zymcos.com/product/asking-coda-about-a-take/

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](https://docs.zymcos.com/product/production-bible/#asking-coda).

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)").
