> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cineflow.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Write and manage your film script in CineFlow

> Draft, import, and organise your screenplay in CineFlow's dedicated script workspace, with scene navigation, AI assistance, versioning, and export.

The Script workspace is a first-class writing environment built for film production. You can draft a script from scratch, import an existing one, navigate scenes in the left panel, link scenes to your shot list, and export or share the finished document, all without leaving your project.

## Opening the script workspace

From your project sidebar, select **Script**. The workspace loads with a full-width editor in the centre, a scene navigator on the left, and a toolbar across the top for AI, import, export, share, and versioning actions.

## Writing a script

Click anywhere in the editor and start typing. The editor uses Fountain-style screenplay formatting. As you add content, CineFlow automatically detects scene headings and populates the left-hand scene navigator so you can jump between scenes instantly.

<Tip>
  Scene headings are detected when they start with `INT.` or `EXT.`. Keep your headings in this format for the navigator and the shot list linker to work correctly.
</Tip>

## Navigating scenes

The left panel lists every scene heading in order. Click any scene to scroll the editor straight to it, useful on long scripts where scrolling would be slow.

Collapse the scene navigator to get a wider writing surface by clicking the panel toggle in the toolbar.

## AI-assisted writing

CineFlow's AI can help develop your script in several ways. See [AI-assisted script writing](/ai/script-ai) for the full guide. The quick summary:

<AccordionGroup>
  <Accordion title="Polish">
    Improves dialogue, action lines, pacing, and clarity while preserving your original intent and structure.
  </Accordion>

  <Accordion title="Continue">
    Writes new screenplay pages that continue from the end of your current script, matching your established tone and characters.
  </Accordion>

  <Accordion title="Generate shots from a scene">
    Reads a scene and suggests individual shot setups, shot type, angle, lens, movement, ready to add to your shot list.
  </Accordion>

  <Accordion title="Smart scene import">
    Paste unstructured notes or a treatment into the AI importer. CineFlow parses the text and converts it into properly formatted scenes.
  </Accordion>
</AccordionGroup>

<Note>
  AI features require an internet connection and use CineFlow's cloud AI service (Anthropic Claude). No API key or configuration is needed.
</Note>

## Importing a script

If you already have a script in another format, you can bring it into CineFlow without retyping.

<Tabs>
  <Tab title="Import from PDF">
    <Steps>
      <Step title="Open the import dialog">
        Click **Import** in the toolbar and select **PDF**.
      </Step>

      <Step title="Upload your file">
        Choose a PDF from your computer. CineFlow extracts the text and converts it into editable script content.
      </Step>

      <Step title="Review and confirm">
        Check the preview for any formatting issues, then click **Confirm import** to replace the current editor content.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Import from plain text">
    <Steps>
      <Step title="Open the import dialog">
        Click **Import** in the toolbar and select **Text**.
      </Step>

      <Step title="Paste or upload">
        Paste your screenplay text directly, or upload a `.txt` or `.fdx` file.
      </Step>

      <Step title="Confirm">
        Click **Confirm import**. CineFlow parses the sluglines and formats the script automatically.
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Warning>
  Importing a script replaces the current editor content. Create a snapshot first if you want to preserve your existing draft.
</Warning>

## Linking script scenes to shots

Once your shot list contains scenes, you can create a two-way link between a script scene and its corresponding shot list scene. Open the script dock in the shot list (`Alt+\`) and use the chain icon on each scene header to link them. Changes to the script scene heading update the reference in the shot list automatically.

## Commenting and collaboration

You can leave threaded comments on any line of your script. Click the comment icon in the margin next to any scene block to open the comment thread. Team members with access to the project can reply directly, replies trigger a notification back to the original commenter.

## Snapshots and version history

The script editor maintains a full snapshot history. Click **Snapshots** in the toolbar to browse past versions of the document. Each snapshot captures the full script text at that point in time, with a timestamp and optional label.

<Tip>
  Take a snapshot before running **Polish** or **Continue** so you can easily restore your original draft if you want to go a different direction.
</Tip>

## Sharing the script

Generate a read-only link to share the formatted script with directors, executives, or collaborators who don't have a CineFlow account.

<Steps>
  <Step title="Open the share dialog">
    Click **Share** in the toolbar.
  </Step>

  <Step title="Create a link">
    Click **Create new link**. Optionally add a label. Copy and share the URL, recipients see the script rendered in clean screenplay format.
  </Step>

  <Step title="Revoke access">
    Toggle the link off or delete it from the share dialog at any time.
  </Step>
</Steps>

## Exporting the script

Export the script as a formatted PDF from the **Export** menu in the toolbar. PDF exports count against your plan's monthly export limit.
