Skip to content

Advanced Features

This guide covers Storywright's power-user features — chat import, story structure templates, the suggestion inbox, and more.

Chat Import Wizard

You can import an existing chat transcript and convert it into a fully structured Storywright story. This is perfect for turning roleplay sessions from SillyTavern or other platforms into polished, editable stories.

Supported Formats

  • JSONL — SillyTavern chat history format (one JSON object per line)
  • Plain text — Speaker-prefixed messages (speaker: message format)

How to Import

  1. Open the Stories sidebar and click Import Chat.
  2. Select your file — the wizard shows a preview of the raw transcript so you can confirm you picked the right one.
  3. Name mapping — Review and rename speakers. For each character speaker, you can either assign them to an existing character (via dropdown) or let the wizard create a new character card. This prevents duplicate characters when importing multiple chats with the same cast.
  4. Cleanup — Configure which content to strip before import:
  5. System messages — OOC notes, system directives
  6. Code blocks — Markdown fenced code blocks
  7. Image prompts — Stable Diffusion / image generation prompts
  8. Stat tables — Relationship meters, stat blocks
  9. HTML tags — Leftover formatting
  10. LLM cleanup — Optionally send ambiguous messages to a fast AI model to classify as narrative vs. noise
  11. A before/after preview shows exactly what will be kept and what will be removed, with removal reasons.
  12. Scene splitting — Configure how the transcript is divided into scenes:
  13. Scene word target — the approximate word count per scene (slider: 500–10,000 words, default 2,500). The wizard splits the transcript to keep scenes near this target.
  14. Time gap threshold — if the original chat includes timestamps, any gap larger than this threshold (1 hour to 1 week) forces a scene break. Useful for transcripts spanning multiple sessions. The wizard also splits on natural narrative breaks regardless of these settings.
  15. Review and import — Preview the resulting story with its scenes and characters. When everything looks right, confirm the import.

The imported story is fully editable. Each imported scene retains its source text (the original transcript), enabling the Rewrite from Source feature — the AI rewrites the imported text in your chosen style, POV, and tone while preserving the core events and dialogue.

Rewrite from Source

After importing, each scene has a Rewrite button. This sends the original source text to the AI as reference material, producing a polished rewrite that matches your story's writing style and narrative POV. You can also use Rewrite All from Source in the story menu to batch-rewrite every imported scene.

Source fidelity: the rewrite preserves the core events and dialogue from the source text as closely as possible — it reformats and stylizes without inventing new plot points or omitting key beats. This keeps your imported story recognizable while giving it a consistent narrative voice.

Story Structure Templates

Templates guide how the AI plans your story's arc. You select a template during Story Setup → Story Structure. The template provides beat descriptions that shape the AI's planning — giving both you and the AI a framework to build on.

Template Description
Three-Act Setup, confrontation, resolution. The classic Hollywood structure.
Kishotenketsu Japanese four-act: introduction, development, twist, reconciliation. No central conflict required.
Five-Act Exposition, rising action, climax, falling action, denouement. Shakespearean drama structure.
Hero's Journey The monomyth: call to adventure, trials, transformation, return.
Save the Cat Blake Snyder's 15-beat structure for compelling stories.
Story Circle Dan Harmon's simplified hero's journey in 8 steps.
Seven-Point Hook, plot turn 1, pinch 1, midpoint, pinch 2, plot turn 2, resolution.
Fichtean Curve Rising crises that build to a climax. No extended exposition.
In Medias Res Start in the middle of the action, then fill in backstory.
Vignette Collection Loosely connected scenes or snapshots. No traditional arc.
Freeform No structure constraint. The AI plans freely.

Suggestion Inbox

After generating scenes, the AI may notice opportunities to improve your character cards based on what actually happened in the story. Suggestions are generated during post-processing and surfaced for your review.

How It Works

  1. After generation, if suggestions are available, a snackbar notification appears: "N new suggestions ready". Click Review to open the inbox, or dismiss it.
  2. A 💡 badge in the left panel shows the pending suggestion count. Click it anytime to open the inbox.
  3. Suggestions are grouped by character. Each suggestion targets a specific lorebook entry or proposes a new lorebook entry based on continuity facts.

Note: Suggestions never modify character cards directly — cards are canonical identity. Continuity facts (appearance changes, physical state, etc.) are routed to lorebook entries instead.

Scanning for Suggestions

Suggestions are generated automatically after each scene, but you can also trigger a scan manually:

  • Click the ↻ Scan button in the inbox title bar to run a fresh scan against all existing scenes right now.
  • If the inbox is empty, an "Scan Now" button appears in the empty state — use this after editing scene text or importing a chat to surface suggestions from that content.

Pending suggestions older than 30 days are automatically pruned when the story loads, keeping the inbox from accumulating stale items.

What You See Per Suggestion

  • Target field — which field the suggestion applies to (e.g., "personality", "description", "content")
  • Diff view — the current value (red-tinted) and the proposed new value (green-tinted). For new entries, only the proposed value is shown.
  • Rationale — a brief explanation of why this suggestion was made
  • Edit — click the pencil icon to modify the suggested value before accepting

Actions

  • Accept (✓) — Updates the character card immediately. A CardRevision is pushed to the character's revision history, so you can always undo the change from the character editor's version history.
  • Dismiss (✗) — Removes the suggestion. No changes are made.

The suggestion inbox keeps your character cards evolving organically as your story progresses. It's entirely opt-in — you choose which suggestions to accept and which to ignore.

Search across every scene in your current story to find specific dialogue, character mentions, or plot points.

  • Access: Click the search icon in the toolbar, or press Cmd/Ctrl + F in the workspace.
  • Results show matching scenes with snippet previews of the surrounding text.
  • Click a result to jump directly to that scene in the editor.

This is especially useful in longer stories when you need to check consistency or find where you mentioned a particular detail.

Version History

Save named snapshots of your story at any point and restore them later.

  • Save a version — Create a named snapshot with a timestamp.
  • Browse versions — View your saved snapshots in chronological order.
  • Restore — Roll back to a previous version if your changes didn't work out.
  • Delete — Remove versions you no longer need.

Version history is great for experimenting. Save before making major changes, and restore if they don't pan out. It's free insurance.

Content Level System

Control what content is visible and what the AI is allowed to generate, using a tag-based system with four built-in levels.

  • Level selection: Settings → Content Level, or during the onboarding wizard
  • Kids (🌈): Only untagged content. Lighthearted themes only.
  • General (📖): Standard fiction — action, drama, romance. Nothing explicit.
  • Mature (🌙): Adult themes, darker subjects. Not explicit.
  • Unrestricted (🔓): No restrictions. Full creative freedom.

Content tags (violence, horror, romance, dark, profanity, mature, explicit) on stories, characters, lorebooks, and prompts are filtered against your active level. Hidden content is not deleted — just invisible until you change levels.

Generation prompts automatically include content boundary instructions matching your level. After generation, a content validation check flags scenes that may have exceeded your level's boundaries.

See the Settings Guide for full details.

Jailbreak Prompts

For Mature and Unrestricted content levels, you can create and select jailbreak prompts — custom system prompt overrides that replace the default content boundaries. This gives advanced users full control over how the AI handles sensitive content.

Jailbreaks are managed in Settings → Content. Create custom prompts, preview them, and assign one as active. The active jailbreak is injected into the system prompt during generation, replacing the default content boundary block.

Note: Jailbreaks are only available when your content level is set to Mature or Unrestricted. At lower levels, jailbreaks are hidden.

Keyboard Shortcuts

Story Workspace

Shortcut Action
Cmd/Ctrl + S Save story
Cmd/Ctrl + Z Undo
Cmd/Ctrl + Shift + Z Redo
Cmd/Ctrl + F Search across scenes
Escape Close dialogs, dismiss full-size views

General

Shortcut Action
Enter Submit / confirm in input fields
Escape Cancel / close
Tab / Shift + Tab Navigate between form fields

Scene Editor

  • Use the Previous / Next scene navigation buttons to move between scenes.

macOS-Specific Features

On macOS, Storywright adapts to platform conventions:

  • Native sidebar — Uses the macOS-native sidebar (macos_ui package) instead of a Material navigation rail.
  • Unified toolbar — macOS-style window toolbar integrated with the title bar.
  • Platform-adaptive appearance — Follows macOS design conventions while keeping Material-based content areas.

Guided Tour

After completing the onboarding wizard, a guided tour highlights key areas of the workspace — the story list, scene editor, character panel, context panels, and settings.

The tour uses interactive highlights that walk you through each section. To re-run the tour at any time, go to Settings → About → Take a Tour.

Tips

  • Chat import is great for turning roleplay transcripts into polished stories — import, then use Rewrite from Source to transform each scene into your writing style.
  • Assign existing characters during chat import to avoid duplicates — the wizard lets you pick from your character library.
  • Story structures help overcome blank-page syndrome — the template gives the AI (and you) a framework to work within.
  • Save versions before major revisions — it's free insurance against changes you might want to undo.
  • The suggestion inbox is opt-in — you choose which suggestions to accept. Nothing changes without your approval.
  • Search is invaluable in longer stories — find where you mentioned a plot point, check for consistency, or locate specific dialogue.