Using AI Commands

An AI Suggestion answers "what comes next". An AI Command answers "change what is already there" — tighten this scene, punch up this dialogue, proofread the page — and shows you every change it wants to make before any of it counts.

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

• ⌘J (Ctrl+J on Windows and Linux).
• The wand button in the editor toolbar, next to the ✨ AI Suggestion button.
• The wand button in the toolbar that appears over a selection — usually the most convenient one, since most commands act on what you have highlighted.
• Edit ▸ AI Command…

They all do the same thing. If you can see ✨ but not the wand, the two use different models — the suggestion uses your Editor suggestions model and a command uses your Analysis model, so check both are set in Settings → AI.

Asking for a change

The dialogue that opens has two halves, and you can use either or both:

• A command. Pick one from the list — Rewrite, Tighten, Expand, Punch up the dialogue, Fix the formatting, Proofread, Continue from here. Each one says what it acts on: your selection, the block your cursor is in, or the whole document.
• Your own words. Type whatever you want changed.

Picking a command and typing means both. "Tighten" plus "and lose the second beat" does exactly that.

What it is aimed at

The rule is simple: highlighted text is what gets replaced — exactly it. A collapsed cursor is a place to write. Two commands override this: Proofread always acts on the whole document, and Continue from here always writes at your cursor, even when something is highlighted.

You never have to guess. The dialogue itself says what will happen before you press Send — "Replaces the highlighted text", "Inserts at the cursor", "Applies to the whole document" — and while the command runs, the target is drawn in the document too: a filled region where text will be replaced, or a caret bar on the line where text will be inserted. If a collaborator moves the passage while the AI works, the mark moves with it.

While it works

The document is locked while the AI writes — the cursor stops blinking and typing does nothing. That is deliberate: the answer is going to be compared against the exact passage you asked about, and text moving underneath it while it works would compare it against something else.

To get out, press Escape, click the Stop button in the top corner of the editor, or use ⌘. / Ctrl+. — the global AI stop. Stopping discards the answer and leaves your document exactly as it was. (⌘. only means "next change" once a review is on screen; while nothing is running, and nothing is under review, it does nothing.)

Reviewing the changes

When it finishes, nothing has been committed yet. The changes appear in place, in the document:

• Text the AI wants to add is underlined.
• Text it wants to remove is struck through.
• A whole new or deleted block gets a bar down its inside edge.

Both readings are on the page at once, so you can see what would be lost as well as what would be gained.

The review bar tells you how many changes there are and lets you walk them:

Changes are split the way a person would split them — by word and by block, not by character — so "Accept" always means something you can read.

You do not have to finish in one go. The document is editable again as soon as the AI is done, and you can keep writing with changes still pending; anything you type stays yours whichever way you resolve the change around it.

Undo works normally

Every step is one ⌘Z:

• The whole set of proposed changes appearing is one step. Undo it and the document is exactly as it was.
• Each Accept and each Reject is its own step.
• Accept all and Reject all are one step each.

Nothing the AI does is folded into the sentence you typed just before it, so undo never takes back more than you meant.

Rewriting a speech, a scene, or an action

The floating toolbar offers three shortcuts that skip the dialogue entirely: Rewrite this dialogue (when your cursor is in a character cue, a parenthetical, or a speech), Rewrite this scene (in a scene heading), and Improve this action (in action or a shot).

These act on the whole unit — the entire speech from cue to last line, the entire scene, the whole run of action — no matter what you have highlighted. Pressing Rewrite this scene with two words selected still means the scene. The result arrives as the same reviewable changes as any other command.

Which model runs a command

Commands use the model set for Analysis in Settings → AI, not the one set for Editor Suggestions. A suggestion is something you sit and wait on, so that setting prefers the fastest model; a command is a considered rewrite and is better served by a slower, stronger one.

Related

• Using AI Suggestions — ask what comes next.
• Using AI Chat — a conversation about your project.
• Enable AI — connecting a provider and choosing models.