Skip to content
EpicDraft Docs

Using AI Suggestions

An AI Suggestion answers "what comes next" — the rest of a line, the speech under a character cue, the next beat of action. It reads what you have written so far and offers a continuation you can take or ignore.

Suggestions only ever appear when you ask for one. Nothing is offered while you type, and nothing arrives because you paused.

Asking for one

There are three ways in, in the screenplay editor, on a Library page, or in any rich-text field:

  • The ✨ button in the editor toolbar, and in the toolbar that appears over a selection.
  • Edit ▸ AI Suggestion.
  • Shift + Tab.

With the caret at the end of a line, the suggestion continues from there. With text highlighted, it offers a replacement for what you have selected — the passage being replaced is struck through while the answer is on screen, so you can see what accepting would take away.

Taking it or leaving it

The answer streams in as ghost text at the caret, with anything that becomes new elements — a scene heading, a character cue and its dialogue — previewed below the line.

  • Tab (or tapping the suggestion — on a phone, that's the only accept) takes it. Structure lands as real elements, not as literal INT. or ## characters.
  • Escape throws it away.
  • Asking again without moving the caret gives you a different answer rather than the same one twice.

While a suggestion is being generated the editor holds still — typing is paused so a half-written answer can't be scrambled by the next keystroke. Escape gets you straight back to writing, and ⌘. / Ctrl+. — the global AI stop — cancels it too.

Autocomplete while typing (experimental)

A separate, lighter feature, off until you switch it on in Settings ▸ AI ▸ Default AI ▸ Autocomplete while typing. Once it's on, pausing for a moment at the end of a line shows a prediction of the next few words as faint ghost text at the caret.

  • Tab (or tapping the ghost text) accepts it.
  • Keep typing and it either follows along, when you're writing what it predicted, or quietly disappears.
  • Escape dismisses it.

Unlike a suggestion, autocomplete never pauses the editor and only ever offers the rest of the current line. It sends the few lines around your cursor to the model each time it asks, so it belongs with a small, fast model — pick one for the Autocomplete row under Models by category if the automatic choice feels slow. Character cues and transitions are left to the built-in autocomplete, which already knows every name in your script.

It works on Library pages too — character sheets, locations, outlines, notes — in paragraphs, list items and quotes. Headings are left alone.

Continuing past the end

When the caret has sat still at the end of the script for a minute — nothing typed, nothing moved, nothing arriving from a collaborator — a quiet strip appears under the last page offering to continue the script: the next scene, the next action beat, or the next line of dialogue, defaulting to whatever kind of element the script ends on. It's the same suggestion machinery, aimed at the blank space after your last line.

The strip also appears on a script that already has its end card, in case the ending isn't final after all — a continuation there lands above the card. And it carries an outline check, which reads the scenes you have and points out what the outline promises that the script doesn't deliver yet.

Which model runs a suggestion

Suggestions use the model set for Editor suggestions in Settings → AI. A continuation is something you are waiting on, so that setting prefers the fastest model you have configured rather than the strongest.