Changelog
What changed in each release of Return.
-
Document Templates: one library for your templates and playbooks, new documents from a template or a whole series from a table, and Cloud answers that are never shown cut off.
Added
- Document Templates in Settings: one library for the documents you start from again and again and for your playbooks. Save any open document as a template from the Save button.
- New from Template in the file tree, the File menu, the New button and the command bar (/template). Fill placeholders saves Markdown, PDF or HTML, or a whole series from a CSV table, one document per row.
Changed
- Playbook Check is easier to reach: from the file menus, Quick Actions and the command bar, with the starter playbooks ready in its window.
- Security hardening for previews, links and searches across your documents.
- Smaller improvements to the editor and the interface.
Fixed
- A Cloud answer that runs out of room is never shown as complete, and a Return never edits your text with half an answer. An answer that brought you nothing does not use up an action.
-
Playbook Check, missing clauses in Risk Assessment, new reading defaults, and local models that finish what they start.
Added
- Playbook Check: check a contract against your own playbook, position by position, with a verbatim quote behind every verdict. Fix a deviation with your preferred position, accept it for this contract (the decision travels with the file), insert your model wording for a missing clause, and save the result as a report. Start from a template (services agreement or mutual NDA, in English and Polish) or draft a playbook from your own contract template.
- Risk Assessment lists clauses the document lacks altogether under "Not found in the document", instead of attaching them to an unrelated passage. They are checked when the whole document is analyzed in one go; otherwise the result says they were not checked.
- When the chat saves a lasting rule to a document, the answer shows it, with Undo.
Changed
- Text inside a document is treated as data, never as instructions: a file name, summary, selected text or rule from a document can no longer pass itself off as part of the AI instructions. Rules saved in a document guide the writing but never override what you ask, and classifying an imported document no longer adds rules on its own.
- Documents read in your system font at 16 px with a 1.5 line height, in a Standard column of about 70 characters per line, under calmer headings. Dark mode text is slightly softer on the eyes. If you never changed the typography settings you get the new defaults; anything you set yourself stays as it was.
- One assessment at a time: running Risk Assessment again puts the earlier result away instead of stacking its highlights on the same clauses, and the eye on the result card or in the Assessments popover hides a result and brings it back. Result cards in chat share one quieter frame.
- The send button in the chat box is drawn as an Enter arrow.
Fixed
- The status bar stays on one line: a long status, such as a model that is loading, shortens to fit and scrolls into view when you point at it, and Sign in and the document stats keep their place.
- Mistral Small 3.2 running locally can work through a document in several steps in the chat, reading sections and making edits, instead of stopping with an error after the first step.
- GPT-OSS running locally finishes longer chat tasks that read and search several parts of a document, and Risk Assessment and other Returns with a structured result work with it instead of failing on every section.
- When an assessment such as Risk Assessment does not finish, because the model ran out of room for its answer or some parts of a long document could not be checked, the result says so instead of reporting that no issues were found.
- Long Polish documents analyzed locally in sections are no longer cut off or stopped with a context error: Return now measures how many tokens the text really takes for the loaded model.
- Retry failed sections works on documents that end with an empty line, instead of reporting that the document changed since it was analyzed.
- Retry failed sections keeps the findings you dismissed, the annotations you deleted and the notes you edited, instead of bringing them back.
- A summary or rule that contains --- no longer breaks a document's properties, and classifying an imported document no longer overwrites what you typed while it ran. When a document's properties cannot be read (for example a date written in another app's format), Document Details and Analyze say so instead of adding a second block of properties above them.
-
The model menu in the status bar keeps up with your downloads, and support reports describe a Mac correctly.
Fixed
- A model you download or delete while Return is running appears in, or leaves, the Local menu under the AI chip in the status bar right away, without a restart. On Windows this also brings back the list of models above the processor and graphics card choice.
- On a Mac, the technical details attached to a support report say that local models run on the graphics chip through Metal, instead of on the processor.
-
Help from inside the app, a status bar that shows and switches where AI runs, and one consistent set of icons.
Added
- Settings has a Support page: report a problem, suggest an idea or ask a question without leaving Return. Paste screenshots, black out anything private, and see exactly what will be sent. Nothing leaves until you press Send, and your documents and chats are never attached.
- Click the AI chip in the status bar to switch between Local and Cloud, choose which downloaded model Local runs and, on Windows, whether it runs on the processor or the graphics card. Each option says what it needs, nothing switches until you choose, and AI settings are one row away.
- Choose a Return's icon in Settings → Returns from a grid of icons for document work, or search for one: type contract, deadline or court. Built-in Returns each have their own icon, and a Return looks the same on the Quick Actions bar, in menus and in the command palette.
Changed
- The status bar leads with where AI runs: Local with the model name, or Cloud with the actions you have left and when the limit resets. Plan badges and the usage bar are gone, Upgrade is a quieter button, and on Windows a graphics card icon shows when local models run on the graphics card.
- Icons across the app are redrawn as one consistent set with a single line weight and style, and the send button in the chat box is now an arrow. The license of the icon set is listed in Settings → About.
- The formatting toolbar appears when you release the mouse, over the finished selection, instead of following the pointer while you select.
Fixed
- Formulas you ask the chat for go into the document as calculation lines with their results, instead of a code block you had to unwrap by hand.
- Selecting text with the mouse stays smooth in long documents, including paragraphs that wrap over several lines.
- Menus opened from a button stay with it when you scroll, and close when the button scrolls out of view.
- On Windows, a warning that some actions were unavailable no longer appears at startup when every Return is in place.
-
Charts, formulas and images come through in export, and Word, OpenDocument and PDF files convert with their numbering, tables, footnotes and pictures.
Added
- PDF and HTML export include charts as pictures, formulas with their results, and the images placed in your document, so what you hand to a client looks like what you see in Return.
- HTML export uses the prose font you chose in Settings and carries it inside the file, so the page reads like the editor on any computer, with no internet needed.
- Tables, footnotes and link addresses in Word documents come through in the converted text, and bulleted lists keep their nesting.
- Pictures in Word and OpenDocument files come through the conversion. Each one lands in an assets folder next to the converted document and shows up where it was in the original.
- After converting a Word document, Return tells you if it had tracked changes, which are converted as accepted, or comments, which are not carried over, and how many pictures or drawings were left out.
- A picture that cannot be converted, because of its format, its size, or because it was only linked from another file, leaves a note in its place, and Return warns you after the conversion.
- PDF conversion keeps the pictures on the page: signatures, stamps and photographs land next to the document and appear where they were. Logos that repeat on every page and page backgrounds are left out.
- A scanned PDF no longer converts to an empty document. Each scanned page comes through as a picture you can read in the editor, and Return tells you that its text was not recognized.
Changed
- Word documents keep their clause numbering when converted. Numbers such as 1., 4.2. and (a) appear exactly as Word showed them, instead of turning into plain bullets.
Fixed
- PDF export keeps every dollar sign as written. A line with two amounts, or a placeholder such as $AMOUNT next to a formula, used to come out as garbled symbols.
-
Local models answer Risk Assessment and Plain-Language Notes reliably, and Return says so when an answer could not be read.
Fixed
- Risk Assessment, Plain-Language Notes and other Returns with a set format now come back in that format on every local model, including Qwen3.5, which used to answer loosely and sometimes with nothing usable.
- When a local model gives an answer Return cannot read, the result says so instead of showing an empty card that looked like all clear.
- The local AI engine frees its memory when Return is shut down by the system or from the terminal, not only through Quit.
-
Return comes to Windows.
Added
- Return is now available for Windows (64-bit). The same app and the same built-in local AI, with nothing leaving your computer.
Fixed
- Editing a table no longer scrolls the page away from it. Adding a row, using the row and column menu, or moving between cells with Tab and Enter keeps the cell you are working in on screen.
-
Headings become addresses: links jump to them, citations click through, and a table of contents writes itself.
Added
- Links to headings. Click a link like [Termination](#11-termination) to jump to that heading, or one like [Annex](annex.md#scope) to open that file at it. Same form Obsidian and GitHub use, so the links keep working outside Return.
- Table of contents in the insert menu (+ or /toc): a nested list of links to the document\u2019s headings, one to three levels deep. Plain markdown you can edit.
- Section citations in a chat answer are clickable: the one you are reading opens at the clause it names.
Changed
- Sections are named by their heading wherever they appear: the outline, the section menu and the source chips on a Return. The internal numbering that used to sit in front of them, and could be mistaken for a clause number, is gone.
Fixed
- Clicking a section in the explorer scrolls to that heading in every document, whether or not you already had it open.
-
A theme you choose, charts that follow your formulas, and answers that cite your document's own sections.
Added
- Choose how Return looks in Settings, under Appearance: follow your Mac, or stay Light or Dark regardless of it.
- Insert a chart from the insert menu (+ or /): choose Pie, Bar, Line, Timeline or Flow and Return writes a ready-to-edit scaffold with the title selected. A new Help article, Charts and code blocks, covers editing, colors and limits.
- Charts can draw from your formulas: write a value name such as $rent where a number goes in a diagram, and the chart follows the value as it changes, including when you rename it.
Changed
- Colors are easier to read in both themes, most of all in Light: hints and secondary text are darker, links and buttons keep their contrast, and the Safe, Review and Risk colors look the same everywhere they appear.
- Charts in the Light theme use deeper colors with white labels, so every slice and bar stands out on a white page.
- Switching to Local starts the on-device engine straight away, so your first question does not wait for it and Settings no longer reads Not running until you ask something.
Fixed
- Answers name sections the way your document numbers them, such as Section 11 (Term and Termination). Earlier versions could quote an internal address that looked like a clause number but was not one.
- A prompts file left behind by Return 1.1 or earlier no longer freezes the AI prompts at that version. It is now ignored, Settings shows a note about it, and Restore all defaults archives it.
Removed
- The explorer no longer lists configuration files under your documents. Returns, prompts and preferences are edited in Settings.
-
PDF preview, files Return cannot open, and search on documents not indexed yet.
Changed
- Typing three backticks on an empty line now opens a closed code block, so the rest of the document stays as it was.
- Inside a code block, Tab indents the line instead of moving focus out of the editor.
Fixed
- PDF preview works in the installed app again.
- Files Return cannot open, such as Pages documents, videos or archives, now say so and offer to reveal them in Finder.
- Long descriptions in Settings stay inside their cards on macOS 15.
- Asking about a document that is not indexed yet now searches its text directly and says so.
- Blanks the AI leaves for you use the placeholder format Return recognizes.
- The Full content width fills the window edge to edge, without sideways scrolling.
-
Formulas, images and diagrams in your documents, a complete menu bar, and a hardened local AI engine.
Added
- Formulas: start a line with $ to define a value ($rate = 11,5%) or calculate in place ($ $principal * $rate). Results show beside your text, update as you type, work inside tables, and are never written into the file. The AI assistant knows the syntax too.
- Images display in the editor: put  on its own line and the picture appears in place. Paste a screenshot or drop an image file and Return saves it next to your document. Image files open as a preview from the explorer.
- Diagrams render in your documents: a mermaid code block draws itself as a flowchart, sequence or other diagram, in light and dark mode. Double-click a diagram to edit its source.
- Attach screenshots to chat messages (paste with cmd+V, up to 8) and ask Cloud AI about them. Cloud AI can also read images embedded in your documents when your question depends on them. The local model cannot see images yet.
- The menu bar is complete: File, Edit, View, Window and Help hold every app command, and a Returns menu runs any Return on the current document. Save As (cmd+shift+S) saves a copy and switches to it.
- Table columns can be resized: drag the edge of a column header, double-click it to reset. Widths are remembered per document and never written into the file.
- Right-click a chat message to copy its text or check when it was sent; Return results also show how long they took.
- The local model unloads itself after 30 minutes without a question, freeing memory for other apps. Change or switch this off under Settings → AI → Advanced.
Changed
- The local AI engine is hardened: only Return can talk to it, its memory needs are read from the model file itself, and Settings show when a model is starting or why it failed.
- Return requires macOS 14 or newer; the built-in AI engine starts on Sonoma and Sequoia.
- Return writes files only to places you have pointed it at: your workspace folders, or a location you chose in a dialog this session.
- Typing a bracket or quote with text selected wraps the selection instead of replacing it. Works with ( [ { and quotes, and with * _ or backticks on regular text.
- Result cards in chat are simpler: Open as Document sits next to Insert, and the buttons behave like ordinary buttons.
- The status bar now says in plain words what the local engine is doing: warming up a model, a model asleep after a quiet spell (it wakes on the next question), an engine error with the reason a hover away, and how many documents are being indexed for search. When two things happen at once the line alternates between them, so nothing is missed.
Fixed
- The insert menu (+ or /) is fully keyboard-driven, and pasting a whole markdown file folds its metadata block into the document details instead of showing it as text.
- Placeholders inside code blocks and diagrams are left alone, and filling placeholders in an unsaved draft proposes the draft title as the file name.
- Right-clicking an empty line no longer offers AI actions for it, and explorer errors show as an in-app notice instead of a system dialog.
-
The explorer follows you, changes made in Finder are noticed, and damaged settings can be restored.
Added
- If your settings file gets damaged, Return tells you and offers to bring your folders back from its backup, on this launch or the next.
- Open Files shows a small dot on documents semantic search cannot see, with the reason on hover.
Changed
- With the Open Files list collapsed, the explorer opens the folder your document lives in and scrolls to the section your cursor is in.
- Code files (JSON, YAML, TypeScript) use the full width and scroll sideways like a code editor. Prefer wrapping? Turn on "Wrap long lines in code" in Settings → Appearance.
- Workspace search gives every folder a fair share of the results, and dropping a file onto empty sidebar space asks which folder when you have more than one.
Fixed
- Files renamed, moved, deleted or created in Finder are picked up right away: the sidebar and the search index follow them.
- Dragging a folder from Finder anywhere into the window adds it to your workspace, hidden folders no longer appear as empty, and code projects with node_modules no longer freeze the sidebar.
- Right-clicking in the Find bar or the line gutter gives the field its own menu, and workspace folders with similar names ("Notes", "Notes2") no longer affect each other.
-
Right-click menus everywhere, clearer AI buttons, and steadier scrolling.
Added
- Right-click text in the editor for cut, copy, paste, Ask about this, AI rewrite, any Return, or Find in document. Chat selections, Quick Action buttons and chat messages have their own menus too.
Changed
- AI buttons explain what they need instead of failing quietly: no model, not signed in, or no Pro each point to the fix.
- Settings → Account reads as one card when signed out.
Fixed
- Scrolling through very long documents is steady, and clicking back into the document places the cursor where you clicked.
- Dragging a section from the explorer no longer sweeps a text selection along the way.
- The browser's Reload and Inspect Element menu no longer appears anywhere in the app.
Removed
- The red warning tint on stray formatting characters (*, _, ~) is gone; it flagged ordinary text far too often.
-
Tables you edit in place, AI at the cursor, and a chat that knows what you are looking at.
Added
- Insert at the cursor: type / on an empty line or click the + beside it to add a table, image or code block, or ask the AI to draft the passage from the surrounding section.
- Run a Return from the cursor and have its result land there. Pick what it should read (this document, another one, or a single section) and see the cost before you start.
- Chat knows what you are looking at: the AI sees your assessments, annotations and the section on screen, so "what is flagged red?" or "summarize this part" just work.
- Run a Return on another result, regenerate a result and compare versions, or open any result as a new document you can edit and analyze further.
- Drag to run: drop a document, a section or selected text onto a Quick Action. Text selected in a chat reply can be dragged into the document too.
- Documents in the file explorer expand into their sections: click one to jump there, right-click to run a Return on that section alone.
- Return remembers where you left off in every document, imported PDFs included, even after a restart.
- Edit the system prompts behind the AI features in Settings → Prompts, and tell the AI who you are in Settings → AI → Personalization. Both survive app updates.
- Make the layout yours: drag the edges of the explorer and chat panel, choose the document column width in Settings → Appearance, and Return remembers it.
- A single click previews a file in a temporary tab that the next click reuses; double-click or start editing to keep it open.
- The chat box keeps an unsent draft per document and brings back earlier prompts with the up and down keys.
Changed
- Tables are edited in place: click a cell and type, format with the toolbar, right-click for every table operation, and copy a block of cells straight into Excel or Word.
- CSV files open as spreadsheets you can type into, and code blocks are edited in place with syntax colors. Opening a file never alters it.
- The cursor moves predictably: arrow keys flow through tables and code blocks and never pause on the hidden markdown behind headings, bold text or links.
- Annotations are easier to work with: edit a note in place, jump from the lists straight to the fragment, and hover a finding to light up its text.
- The conversation stays easy to scan: long results open as a short preview, older results fold to one line, and the eye on a result hides its highlights.
- AI output follows your language: chat replies in the language you write in, Returns answer in the language of the document.
- AI edits leave fill-in placeholders like [CLIENT_NAME] untouched unless you ask, and writing into an empty document inserts right away.
- Search is simpler: semantic search turns on with one click, and results show clean excerpts with matches in bold.
- Lists read the way legal documents do: quiet markers, aligned numbers, roman numerals that continue on Enter, and Tab nesting 1. → a. → i.
- A quieter interface: one sparkle signal wherever the AI is working, a smooth rounded text selection, dividers from three dashes, reorganized Settings navigation, and an explorer that always shows where you are.
Fixed
- Clicking back into a document simply puts the cursor there, popups stay attached to their text while you scroll, and typing stays smooth in very large documents with many highlights.
-
Batch processing for large documents, a smarter model library, and PDF export fixes.
Added
- Analyze documents too large for a single pass - Return splits them, works through each part, and combines the results automatically.
- Imported PDFs and files opened from outside your workspace are now searchable by meaning in chat.
- The model library now highlights the best local model for your Mac.
- The file explorer now highlights the file you are working on and expands its folders in the tree so you can see where it lives.
- Documentation now includes screenshots, and inline UI icons - rendered both in the app and on the website.
Changed
- Refreshed the local model catalogue with newer models, each described by what it is good at.
- The command palette (type "/") now runs a workspace search directly and lists only commands that do something.
Fixed
- AI features now always use the model you selected in Settings.
- More accurate memory estimates for the latest models, so they are no longer flagged as too large for Macs that can run them.
- Sharper assessment and annotation matching.
- PDF export now wraps long lines, renders tables, keeps your editor line breaks, and large exports open correctly in Preview and other Apple apps.
- Assessment highlights and chat history stay attached to your document when you reopen it - and even when you edit the file in another app.
-
First public release of Return.
Added
- Local-first document analysis with two bundled llama.cpp engines - fully offline, your documents never leave your Mac.
- Returns - reusable AI prompt templates with Traffic Light and inline annotation outputs.
- Semantic search across your workspace, powered by on-device embeddings.
- Cloud AI (Pro) via an Anthropic-backed proxy.