Scenes & the Document Editor
A scene is where your prose lives. You open a scene from the manuscript tree and write it in the Document Editor. This page covers the editor and the metadata each scene carries.
Editor modes
The Document Editor offers four ways to work, and you switch between them freely:
| Mode | Best for |
|---|---|
| Viewer | Reading your scene as finished text |
| CodeMirror | The default writing mode, with inline consistency markers in the margin |
| Monaco | Writing with autocomplete for your character and place names |
| Milkdown | A what-you-see-is-what-you-get rich-text mode |
CodeMirror is the default and shows consistency issues right where they occur (see Consistency & Pre-Flight ). Monaco is handy when you want your cast and locations to autocomplete as you type.
Scene metadata
Each scene carries a small block of structured metadata — its point of view, setting, cast, and status — kept at the top of the scene file. You edit it in a dedicated panel rather than by hand:
| Field | Meaning |
|---|---|
| Synopsis | A one- or two-line summary of the scene |
| Point of view | Whose perspective the scene is told from |
| Setting | Where the scene takes place |
| Characters — current | Who is present in the scene |
| Characters — introduced | Characters appearing for the first time here |
| Status | Drafted / Revised / Needs Attention / Final |
| Word target | An optional word-count goal for the scene |
This metadata is more than record-keeping: it is what lets the Document Assistant and the consistency checker understand a scene in the context of your whole story — who should be present, where it happens, and whose eyes we see it through.
Saving
Save a scene with Ctrl+S. For fiction scenes, Omni Core validates the metadata block when you save and will tell you if it is malformed, so your scene metadata stays well-formed.
Omni Core also watches for external changes — if you edit a scene file in another program, it notices and lets you reload, so the editor and the file on disk never silently diverge.
Referencing a scene
You can copy a scene’s @path reference from the manuscript tree and paste it to the assistant to pin its attention to that scene — useful when you want help that is grounded in one specific part of your book. See The Document Assistant
.
Related pages
- Stories & the Manuscript — the Part/Chapter/Scene structure
- The Document Assistant — AI help inside the editor
- Consistency & Pre-Flight — the inline markers and whole-story check