Guide / Revise

Get editorial feedback on a chapter, as notes in the margin

Ask for a reading of your chapter: style and problems, tics, continuity, what to cut, the opening and the ending, facts to check. Each note quotes its passage; you tick it off, reply, or dismiss it.

Ask for a reading

Open the AI Reader panel (⌘3). Above the message field are the readings, one click each:

ReadingWhat it looks for
Critique (rubric)A scored reading by criteria; see the rubric critique
Style & problemsRepetitions, inconsistencies, clichés, telling where you could show
TicsYour own recurring figures, against the book's grid of tics
ContinuityContradictions with the other chapters: dates, ages, names, places, a scene told twice
What to cutPassages that can go without loss
Opening & endingWhether the first paragraph opens the chapter, and the last one lands it
Facts to checkNames, dates, places and quotations to verify

Select a passage first and the reading is about that passage only.

The same readings are in the command bar: press ⌘K and type tics or continuity.

You need the AI reader set up first; see the editor inside.

What comes back

A short overview in the conversation, a few lines, and the observations themselves in the margin: each one a note attached to the passage it is about, with a colour for its kind.

Open the Notes panel (⌘2) to go through them in the order of the text. Each note says what the reader sees and why. It does not hand you a replacement sentence: that part is yours.

A reading also notes what works. Strength notes mark what should survive the revision; they are hidden while you write, and the filter of the Notes panel shows them.

Work through the notes

For each note you have four moves:

  • Tick it when you have dealt with it.
  • Resolve it when you disagree or it does not matter. The reader will not raise that point again.
  • Reply. Open the thread and ask why? or show me another place where this happens. Send asks the reader to answer in the thread; Note only keeps your reply for yourself.
  • Keep it, to protect it from Dismiss all…, which removes everything a reading just left.

See notes and to-dos for the panel itself.

It does not repeat itself

Each reading is given the notes already in the margin, open and resolved, and is told not to make the same point twice. A point you resolved is settled.

If you have since fixed what an earlier note pointed at, the next reading can resolve that note by itself, with a line saying why.

Annotate: a narrower reading

In the Notes panel, Annotate asks for one kind of note on the chapter or on the selection: Editorial critique, Tics, Fact check, Continuity, or Custom…, where you say what to look for: every place where the narrator knows something she could not know.

Tics

Every writer has figures they lean on. The Tics reading works from a grid you can edit: in the AI Reader panel, open the menu and choose Tics grid…. Each family has a description, examples and a test.

The grid Musset proposes was written for French prose: the corrective antithesis, the reversal, the closing line that concludes, the maxim, the burst of fragments, the one-line paragraph for effect. Rewrite it for your language and your own habits; it is a Markdown file kept with the book.

Tell the reader about your book

If the book's folder holds a file named AGENTS.md, its content goes with every request. Use it for what a reader should know: first person, present tense, British spelling; the narrator is unreliable; no chapter titles.

Getting good readings

  • Read the chapter yourself first. The notes are most useful when they confirm or contradict a doubt you already have.
  • One reading at a time. What to cut and Opening & ending on a finished chapter give you a morning's work. All seven give you noise.
  • Use Continuity late, when the other chapters exist.
  • Treat a note as a question. The reader is often right that something is wrong there, and sometimes wrong about what.

How-to · Last changed 2026-11-20 · Correct this page

Write the book. Finish it.

Free during the beta · $9.90 once from version 1.0 · macOS 14 or later, Apple silicon · Open source

Download Musset — free