Inline AI suggestions#
When Nisaba proposes a small change to your script, it appears right in the text — underlined where it would go — and nothing happens until you say yes.
When you ask Nisaba to tighten a line, fix a slug, or sharpen a beat, she often proposes the edit as marked-up text right where the change would happen. You read it, then keep it or dismiss it.
Note: Inline suggestions are how Nisaba handles small edits to existing text. When you ask her to write or rewrite a whole scene, that work lands in your script immediately — no underline, no popover. You can undo it with
Cmd+Zor restore an earlier version from History. See Undo & redo for how to step back.
How a suggestion looks#
A pending suggestion appears as a dotted amber underline — a soft, dotted line under the affected words. What it shows depends on the kind of edit:
- A replacement or deletion strikes through the old text.
- An insertion shows the new words inline.
- A note is just an amber underline with no struck or added text — Nisaba flagging something for your attention rather than proposing a wording change.
Suggestions target specific spans — the few words or the line that actually changes — not the whole scene. When Nisaba has several small edits for one scene, each one is its own marked span, grouped together.
Continuity notes can quote more than one scene. Each retained quotation names its own scene; identical quoted words appear once. When a quotation cannot be confirmed in that scene, the note stays on the scene without quoting those words.
Reviewing a suggestion#
- Click the underlined text. A small popover opens.
- Read why. The popover shows Nisaba's reasoning, plus the original text (quoted) and the Proposed replacement or Proposed insertion. The suggested wording reveals itself with a brief cuneiform-glyph animation.
- Decide. Use the buttons in the popover, or the keyboard shortcuts below.
Accepting, dismissing, or discussing#
Each suggestion's popover gives you up to three choices:
- Accept — apply the change instantly.
- Dismiss — turn down the suggestion. The underline disappears and your script is untouched.
- Discuss — open the change with Nisaba in chat so you can talk it through or ask for a different take.
From the keyboard, with a suggestion's popover open:
- Press
Ato Accept. - Press
Dto Dismiss. - Press
Escto close the popover without deciding.
Note: A note-type suggestion has no Accept button, because there's nothing to change. Read it, and Dismiss or Discuss it when you're done.
You can also right-click on an underlined suggestion to reach Accept, Discuss, and Dismiss (or Open review for alternatives and batches).
Who made it#
A suggestion can also come from a tool connected to your account with an API key. It shows who made it: your name, or the key's name followed by yours.
You can answer a suggestion from Doctor → Notes too. It shows the passage and the proposed words, with Accept and Dismiss. Once answered, it stays under Answered with who made it and who answered it.
Character suggestions follow the same review flow. Drafting their proposed wording uses your plan; accepting it adds no drafting charge. Some older character or scene suggestions remain pending after Accept, with no error message; your saved text stays unchanged. Dismiss the suggestion and ask Nisaba for a fresh version of the passage.
Spelling corrections#
As you write, a misspelled word can have a subtle wavy underline. Hover to see the correction, or click the word to review it. Right-click it for the top three corrections under Spelling, with More suggestions when there are others. Accept replaces just that word. Press Esc or click outside to close the review without changing your text. You can undo an accepted correction with Cmd+Z.
Spelling checks use a local American English dictionary plus project words, so British spellings such as colour or grey are underlined for now. Known character and location names are skipped. Choose Add to dictionary to remember another word for this project in this browser.
Spelling underlines stay in the editor. They do not appear in the Doctor's notes or its cleared count. Accepting a spelling correction leaves other notes about that line open. Formatting problems still appear as Doctor notes. If the words have changed while you were reviewing a correction, open the underline again. Script reads leave spelling checks to the editor, including words that are spelled correctly but used wrongly in context. Previously saved spelling corrections may still appear.
When Nisaba offers two takes#
Sometimes Nisaba proposes more than one version — an A and a B. The popover shows tabbed alternatives. Press Tab to cycle between them, read each, and accept the one you like.
When several edits come together#
If Nisaba makes a set of small edits across a scene at once, each underlined span shows Part of N edits in its popover, and you get two extra controls:
- Accept All — apply the whole set in one go.
- Dismiss All — turn down the whole set at once.
You can still open each span individually and accept or dismiss them one at a time.
If you edited the text first#
If you change the underlying words while a suggestion's popover is open, the Accept button becomes Accept anyway. The popover warns you the result may not land cleanly. When in doubt, Dismiss it and ask Nisaba for a fresh take on the line as it reads now.
Once your edit is saved, a suggestion whose words are gone loses its underline but is not deleted. It stays in the Doctor's notes as No longer matches the page, with Dismiss. It can't be accepted. Undoing the edit doesn't bring it back; ask Nisaba again for the line as it reads now.
Hiding suggestions#
- Open the toolbar’s Layers control and choose Quiet inline suggestions. This is an account setting — it applies across all your scenes and tabs. It hides only suggestions you didn't ask for; suggestions from something you explicitly requested still appear. Turn the same switch off to bring unsolicited marks back.
- Open the Layers menu in the toolbar to toggle what the editor draws, including inline suggestions.
Hidden suggestions aren't gone — they reappear when you turn them back on. A writer who hid them and then wondered why none arrived can check there first.
Good to know#
- Nothing changes until you accept. A pending suggestion is a proposal sitting on top of your script — your actual words stay put until you click Accept.
- Your place is kept. Accept saves your typing first and briefly pauses editing while the change settles. If accepting fails, your original words stay on the page.
If a suggestion is still pending after a failed accept, Nabu says: “Couldn't apply the suggestion. Your words are unchanged.”
If the script cannot be restored safely, editing pauses and Nabu asks you to reload the page.
Uses your plan: Asking Nisaba to draft or revise — which is what produces these suggestions — draws on your plan usage. Reviewing, accepting, or dismissing a suggestion costs nothing.
Related#
- Working with Nisaba — how to ask for the help that produces these suggestions
- Undo & redo — how to step back from any change
- The editor — your writing canvas, where suggestions appear
- Editor menus — right-click menus, including the one for pending suggestions