# StoryCut docs

How to use StoryCut, for people and their agents. Every page is also markdown: add .md to its URL.

## Pages

- [Exporting to your editor](https://www.storycut.xyz/docs/exporting.md): Use this when someone exports a recording or a timeline: what an export carries, the file path, frame rate and timecode settings, and which editor page to read next.
- [Final Cut Pro](https://www.storycut.xyz/docs/final-cut-pro.md): Use this when someone imports a StoryCut export into Final Cut Pro, or an FCPXML import there fails.
- [DaVinci Resolve](https://www.storycut.xyz/docs/davinci-resolve.md): Use this when someone imports a StoryCut export into DaVinci Resolve, or chooses between FCPXML and OpenTimelineIO for it.
- [Premiere](https://www.storycut.xyz/docs/premiere.md): Use this when someone imports a StoryCut export into Adobe Premiere, or an XML import there fails.
- [Avid Media Composer](https://www.storycut.xyz/docs/avid.md): Use this when someone imports a StoryCut export into Avid Media Composer.
- [Captions](https://www.storycut.xyz/docs/captions.md): Use this when someone wants captions or subtitles for a timeline, or asks where their caption text comes from.
- [YouTube chapters](https://www.storycut.xyz/docs/youtube-chapters.md): Use this when someone wants YouTube chapters for a timeline, or StoryCut says the timeline's chapters won't work on YouTube.
- [Connect your agent](https://www.storycut.xyz/docs/connect-your-agent.md): Use this when someone connects an AI agent to StoryCut, makes or revokes an agent token, or asks what an agent can see and change.

## For agents

- [Reading a project](https://www.storycut.xyz/docs/reading-a-project.md): Use this when you start working in a project: which tools to read it with, in what order, and how timelines, tracks, story panels and takes fit together.
- [Writing proposals](https://www.storycut.xyz/docs/writing-proposals.md): Use this when you propose or revise changes: naming new rows with refs, grouping changes, validate_proposal, update_proposal, a change that no longer applies or conflicts with an edit, limits and what you can't propose.
- [Writing story panels](https://www.storycut.xyz/docs/writing-story-panels.md): Use this when you write, rewrite or lay out lines: label versus body, forking a shared story panel, TimelineStoryPanelsCreateAction, choosing a track.
- [Building timelines](https://www.storycut.xyz/docs/building-timelines.md): Use this when you make a Short or another timeline, reuse the main video's story panels, duplicate a timeline or reorder one.
- [Clips from transcripts](https://www.storycut.xyz/docs/clips-from-transcripts.md): Use this when you propose clips or takes from a transcript: converting a media file's times to the recording's, ratings, hero and stitched takes.
- [Sketching in StoryCut](https://www.storycut.xyz/docs/sketching.md): Use this when you draw a sketch for a story panel or a note: the box's aspect ratio, the shapes and their JSON Schema, and how to check a drawing.