To send notes back to your AI in One Clear Reader, select the words you want changed, choose Add note (or press ⌥⌘N), type what should change and press ⌘Return. Repeat for each spot. Then click Review and Copy as prompt, and paste into Claude, ChatGPT or Cursor. The prompt quotes every passage with your note.
How do I leave a note on part of a document in One Clear Reader?
To leave a note in One Clear Reader, select the text, add a note and save it. The note sticks to those exact words.
- Select any words on the page. A small bubble appears with Add note and Copy feedback.
- Choose Add note, or press ⌥⌘N.
- A box opens under your selection with the quote at the top. Type what should change in "What should change here?".
- Press ⌘Return, or click Save note.
The words are now highlighted on the page, and the Review button in the toolbar shows how many notes you have. Hover a highlight to see its note.
You can leave the note empty. It then counts as "No comment, just flagged", which is handy for "look at this again".
Free keeps 3 notes per document. Pro has no limit. Notes you already made stay when you hit the limit. You just can't add another until you remove one.
How do I see and manage my notes in One Clear Reader?
Click Review in the One Clear Reader toolbar. The Review notes panel lists every note on this document:
- The heading it sits under, the quoted text and your note.
- Show scrolls to the highlight and makes it pulse.
- Remove deletes that note.
- Clear notes at the bottom removes them all.
Notes are saved on your Mac only. They never change the document itself.
How do I send all my One Clear Reader notes to my AI?
To send all your notes to your AI, click Review, then Copy as prompt, and paste into your AI chat.
The prompt names the file, asks the AI to go through each note, and quotes the exact text. Say Sam left two notes on a plan. The clipboard gets this:
Please revise `/Users/sam/Projects/launch/plan.md`.
I reviewed it and left 2 notes. For each note, quote the text it refers to, say what you will change, then update the file.
1. In "Rollout":
> We ship to every user on day one.
Note: Start with 10% of users for a week.
2. In "Budget":
> $4,000 for ads
Note: Where does this number come from?Because the full file path is in the prompt, a coding AI like Claude Code or Cursor can open the file and make the changes itself. A chat AI in the browser can't reach your Mac, so paste the document in too, or ask it for the corrected text.
Your notes stay in the panel after copying, so you can check them off when the new version arrives.
How do I check my AI fixed my notes in One Clear Reader?
One Clear Reader's notes tell you when the AI has touched the text you flagged. When the AI saves the file, the page refreshes by itself. Any note whose quoted text is no longer on the page shows This text has changed with a green tick.
That tells you the AI touched that spot. Read the new version to check it did what you asked, then Remove the note.
How do I see what my AI changed in One Clear Reader?
One Clear Reader marks what changed in the file for you, in two ways.
Changed since the last refresh works while the file is open. When your AI saves the file, a bar appears above the page: "3 sections new or changed since the last refresh". Changed blocks are marked on the page.
- Next change jumps to each changed block in turn.
- Show only changes hides everything else. Click Show full document to go back.
- Dismiss closes the bar.
Changed since your last visit (Pro) works when you come back to a file later. The bar says something like "2 sections new or changed since you last read it yesterday", and the changed blocks are marked. One Clear Reader remembers this for your last 80 files. On Free you see the count and a See what changed button, without the marks.
For more on this, see how to see what your AI changed.
How do I send feedback on one passage from One Clear Reader?
To tell your AI about one passage, use Copy feedback in One Clear Reader. It's quicker than a note when you only have one thing to say.
- Select the passage.
- Press ⇧⌘C, or choose Copy feedback in the bubble, or
Edit › Copy Feedback Context. - Paste into your AI chat and type your comment after "My feedback:".
The clipboard gets the file path, the section heading, the selected text and a "My feedback:" line ready for you:
File: /Users/sam/Projects/launch/plan.md
Section: Rollout
Selected text:
We ship to every user on day one.
My feedback:To point at a whole section instead, hover its heading and click #. That copies a link to the section (the file path plus the heading) that you can paste into a chat.
How do I share my One Clear Reader notes with a colleague?
To share your notes with a colleague, save them as a .notes.md file next to the document.
- Click Review, then Save as file. Or press ⌘K and choose Save notes as a file to share.
- A save window opens in the document's folder, with a name like
plan.notes.mdalready filled in. Click Save. - Send both files, or keep them together in a shared folder.
The notes file is readable Markdown: a heading for each note, the quote and the comment. Anyone can read it in any app. It also carries hidden data so One Clear Reader can put the notes back on the page.
When someone opens the document in One Clear Reader with the notes file beside it, a message appears: "plan.notes.md has 2 notes on this document." They click Show them here to add the notes to their page, or Not now.
Saving notes as a file is the only way they leave your Mac. One Clear Reader never uploads notes anywhere.
Can Claude Code ask me for a review in One Clear Reader?
Not yet. The One Clear Reader app download doesn't let Claude Code request a review or collect your notes by itself. For now, Copy as prompt does the same job with one paste.
If you review Claude Code plans often, how to review a Claude Code plan before you approve it walks through the whole routine.
Which files can I leave notes on in One Clear Reader?
One Clear Reader takes notes on any file that opens as a page: Markdown, text, Word, EPUB, web pages and spreadsheets. PDFs open in the Mac's own PDF viewer, which doesn't take notes.
Questions people ask
Do One Clear Reader review notes change my file?
No. One Clear Reader review notes are saved on your Mac, separate from the document. The file only changes if you edit it or your AI does.
How many notes can I leave in One Clear Reader for free?
One Clear Reader Free allows three notes per document. Pro removes the limit, and the 30-day trial includes it.
Does One Clear Reader's Copy as prompt work with ChatGPT in the browser?
Yes, paste the Copy as prompt text into ChatGPT like any text. A browser chat can't open files on your Mac, so also paste the document or ask for the revised text back.
What does "This text has changed" mean on a One Clear Reader note?
"This text has changed" means the words you quoted are no longer on the page, usually because your AI rewrote that part. Check the new text, then remove the note.
Is Copy feedback the same as Copy as prompt in One Clear Reader?
No. In One Clear Reader, Copy feedback copies one selected passage with the file and section, ready for you to type a comment. Copy as prompt copies every saved note at once.
Related: editing a file yourself, keyboard shortcuts.