Every project can hold multiple Scripts: block-based screenplays with your library and Preview Agent built in. Script is one of the project’s three main views (switch to it from the Script / Studio / Production tabs at the top), and scripts also live in the Scripts panel of the left sidebar: click one to preview it in the panel, double-click to open the editor.
Start a script
A new script opens on a start page with three ways in:
- Upload script: drop in a screenplay as PDF, Final Draft (.fdx), Fountain, or plain text. The agent imports and formats it to match your original: scenes, dialogue, parentheticals, and transitions all land as proper blocks, named from the title page or filename.
- Blank page: straight into an empty editor.
- Brainstorm with Agent: type an idea into the composer and it opens the script with an agent thread attached, ready to develop it with you. Typing anywhere on the start page lands in this composer.
Manage scripts
- Create: click New script at the top of the Scripts panel. New scripts start as “Untitled script”.
- Rename, Copy link, or Delete from a script’s row menu; search the list from the panel header.
- Switch scripts without leaving the editor, from the script switcher in its header.
- Search inside a script: ⌘F (or Search in the script menu) opens a find bar: Enter or ↓ for the next match, Shift+Enter or ↑ for the previous; Escape clears the search, then closes it.
- Export: the script menu’s Export → Fountain downloads the screenplay as a standard
.fountain file.
There’s no save button: every change syncs live, and collaborators can write with you in real time (you’ll see their named cursors). Undo and redo are yours alone.
Write with blocks
A script is a stack of five block types: Text, Scene, Dialogue, Parenthetical, and Transition.
- Add a block: type
/ on an empty line, or click the Add block button on a block’s rail (Option-click adds it above instead of below).
- Convert as you type: the editor offers quick-converts: a lone
( offers Parenthetical, a character chip alone on a line offers Dialogue. The hint reads “Turn into …, or keep typing”; press Tab to take it.
- Reorder or convert: drag a block’s grip handle to move it; its menu also has Ask AI, Turn into…, Copy (⌘C), Copy link (⌘⇧C), Duplicate (⌘D), and Delete.
- Copy link on a block links straight to it. Opening the URL scrolls to the block and selects it. Handy for notes and reviews.
- View block activity (in the grip menu) shows who edited a block and when.
- Scene blocks carry the slug line: an INT. / EXT. / INT/EXT. / EXT/INT. prefix, a location, and free-text time of day. Scene numbers aren’t stored anywhere; they come from position, so inserting, deleting, or reordering scenes renumbers everything automatically.
- Transition blocks offer the standard set (CUT TO:, FADE IN:, DISSOLVE TO:, SMASH TO:, and so on) plus any custom transitions you’ve already used in that script.
- Format selected text with Bold, Italic, Underline, and Strikethrough.
The thin rail on the far left is the scene outline: one tick per scene, sized to its length, appearing once you have two or more scenes. Hover it for the scene list, click a scene to jump straight there, and scrolling your wheel over the rail scrolls the script.
Keyboard flow
The editor is built to keep your hands on the keys. Tab works through a ladder (the first rule that applies wins):
- An open menu takes its highlighted item.
- A quick-convert hint converts the block.
- On an empty Text line, Tab starts a Dialogue and opens the Character menu: press Enter to keep the Dialogue, or Tab again to turn it into a Transition instead.
- Anywhere else in Text, Tab is just a tab character. In a Scene, Transition, or Parenthetical, it moves on to the next Text block; on a character chip, it jumps to the dialogue line.
Other moves worth knowing:
- Enter leaves a Scene or Transition block. In Dialogue, it splits the speech mid-line and leaves the block at the end. An empty Parenthetical dissolves on Enter.
- Shift+Enter adds a line break inside a Parenthetical or Transition.
- Backspace at the start of a Scene, Transition, or Parenthetical turns it back into plain Text.
- ⌘A selects the current block first; press it again for the whole document.
- On a chip: Space opens its menu, Backspace/Delete removes it.
With a character chip selected, Backspace, Delete, or Escape converts the whole Dialogue block back to Text, speech and all. Undo brings it back.
Reference your library with @
Anything saved to your Project Library can be pulled into the script with @: Characters, Locations, and Props. A Dialogue block’s character slot picks up Characters; a Scene block’s slug line takes Locations. Chips point at the same library items the rest of the app uses, so the script and your canvas stay in sync.
New characters aren’t saved until you Create them
Type a name the library doesn’t know and the menu offers Create “Name”. Picking it drops a draft chip and opens the Unidentified elements popover: Type, Name, Description, and an image Add → Upload. Nothing is written to the library until you click Create. Dismiss the popover and the draft chip stays in your script, but it hovers as “Not available in this project” and generation and prompts ignore it. Click Create and every chip in the script sharing that draft links up in one step; to fix a stray draft later, click the chip and pick an existing item or Create it then.
Script AI
Select any text and the toolbar comes with AI built in:
- Enhance, Elaborate, or Continue the selection with one click.
- Enter changes…: describe the edit you want, or dictate it with the mic.
- Send to agent: hand the selection and your prompt to the main chat instead.
- Reach the same tools from any block’s menu via Ask AI.
Proposed edits appear in place for review: Accept (⌘Enter), Discard, or Try again, with a follow-up field to refine further. When the agent edits a script from chat, its changes stream in at a visible caret and collect in a Suggested changes bar, where you step through them one at a time or Accept all / Reject all. On an empty script, a first draft applies immediately with nothing to review.
A few rules that keep review sane:
- Only one AI change can be pending at a time. Inline Script AI and agent edits wait for each other.
- If a collaborator edits inside a pending proposal, it’s invalidated rather than applied (“Selection changed — try again”).
- Accepting an AI change is a single undo step, and during an agent review, undo won’t cross back past the moment the review started.
- While suggestions are pending, scene-number chips preview both the old and new numbering.
Scripts and the rest of your project
Scripts don’t link directly to sequences, shots, or generation: the bridge is Preview Agent, which has your script and the whole platform in the same conversation. Ask it to build a shot list from the script, storyboard a scene, break down what a sequence needs, or ideate new directions from what you’ve written. Your open script is automatically part of the agent’s context, so “board out scene 3” just works.