Overview
Select some text and the Highlight Bar pops up with a set of one-click rewrites and a settings gear.
Select a passage and the Highlight Bar appears: Ask Quarkle, Expand, Embellish, Concise, Restructure, and a settings gear.
The actions
- Ask Quarkle sends the passage to Quarkle Chat so you can talk it through instead of rewriting it. Shortcut: Ctrl/Cmd + Shift + L.
- Expand lengthens the passage using the surrounding chapter for context.
- Embellish adds descriptive, sensory detail.
- Concise tightens it.
- Restructure reorders it for better flow.
Preview, then accept
When you pick a rewrite, the result streams into a card at the bottom of the passage. When it finishes, you see the change as a diff right in your text: added words are highlighted, removed words are struck through. It is only a preview. Your saved manuscript has not changed yet.
A tightened passage shown as a live diff: struck-through words are removed, highlighted words are added. Compare, accept, reject, retry, or copy from the card.
- diff / after / before tabs switch how the preview reads: the marked-up change, the clean rewritten version, or your untouched original.
- Accept (the check) replaces your text with the rewrite. It is a single step you can undo with Cmd/Ctrl + Z.
- Reject (the cross, or Esc) discards the rewrite and leaves your text exactly as it was.
- Retry runs the same action again for a fresh version.
- Copy copies the rewrite to your clipboard without touching the manuscript.
While the rewrite is still streaming, the card shows a Stop button that keeps whatever has been written so far. And if you edit the passage while a preview is open, the preview drops itself rather than apply to text you have since changed.
Steer it like a pro
The settings gear on the Highlight Bar is where these rewrites go from handy to precise. Click it to open a small panel with three controls.
The settings gear: a free-form guide, plus how much surrounding chapter to send as context.
- Guide is a free-form instruction that steers the rewrite. Type something like
keep it under two lines,make it colder, orstay in Mara's voice, then run the action. A dot appears on the gear whenever a guide is set, so you always know it is active. - Context decides how much of your chapter Quarkle reads before rewriting. Above sends only what comes before your selection. Around sends the chapter on both sides, which matters when a line depends on something later in the scene.
- Context size is how much of that chapter text to send: S is a few pages around your selection, M (the default) is roughly chapter-scale, and L sends as much of the chapter as the model can take. Larger means the rewrite is more aware of the surrounding chapter, at the cost of a little speed. Your book notes and the chapter summary are always sent in full, whatever you pick here.
What Quarkle reads as context
A rewrite is never done on the selected sentence alone. Quarkle sends the model three things so the result fits your book, not just the line:- Your book notes. The Author’s Book Notes file (
book-notes.md) from your Story Atlas, in full. Standing facts about your story live here, so this is the surest way to make a rewrite honor your canon. It is always included, whatever your context size. - This chapter’s summary. The running summary Quarkle keeps for the chapter you are editing.
- The chapter around your selection. The current chapter’s text, as much as your Context and Context size settings allow, with your selected passage marked so the model knows exactly what to replace.
The inline bar stays deliberately local: it reads this one chapter plus your book notes. It does not load your whole Story Atlas, your other chapters, or your character and world notes. So if a rewrite needs to respect a fact from elsewhere in your book, put that fact in your book notes, or switch to Chat or the Review Room, which read more widely.
These are small edits, usually a sentence or a paragraph. For feedback on a whole chapter, use the Review Room. To brainstorm a change instead of applying one, use Chat.
Next: Version history
Checkpoints and safe restore.

