Release Notes

New features

• Cursor Agent CLI is now a first-class agent in Flywrite, alongside Claude Code and Codex. After a one-time setup, Cursor Agent can see which file you have open and which lines you’ve selected — ask it about “this file” or “the selected paragraph” and it just knows
• Get a notification when Cursor Agent finishes a task in a Flywrite terminal
• Cursor Agent has its own terminal launcher (⌃4) and tab, and Flywrite names the tab “Cursor Agent” while it’s running
• New Settings → Agents section with a page for each agent — Claude Code, Codex, and Cursor Agent — where you set its terminal shortcut, its notifications, and its one-time Flywrite setup in one place. Preview the exact prompt the setup hands the agent, copy it to paste into a session yourself, or have the agent run it; once installed, the same buttons offer to remove it again

Improvements

• Settings pages are now left-aligned instead of centered
• The Checkpoint and Sync notification toggles now also silence the confirmations for checkpoints and syncs you run yourself, so turning them off truly quiets them (sync failures and merge conflicts still always notify)

Improvements

• The update button now simply reads “Update to vX.Y.Z”, so you can see at a glance which version you’re getting

Fixes

• Files changed outside Flywrite — by Claude Code, another editor, or git — can no longer be silently reverted by an open tab’s older copy. Open files pick up outside changes automatically, saving never overwrites a file that changed on disk, and if you have unsaved edits when a file changes underneath them, a banner lets you choose which version to keep
• Closing and reopening a file now always shows the latest version from disk
• Your cursor position in each file is now remembered across restarts, as intended

New features

• Give each project a look you’ll recognize at a glance: an emoji, initials, or a small icon, with a background and text color (including your own hex). The tile at the top of Appearance is a live preview, and you can rename the project there too
• Settings has a Notifications page so you can turn Claude Code, Codex, checkpoint, sync, and app-update pings on or off. Turn on Claude or Codex to set up the one-time hook

Improvements

• Project Settings opens on Appearance. The old General tab is named Project Settings

Fixes

• Hovering a symlink in the file explorer now reliably shows where it points, instead of a system tooltip that often never appeared
• The selected folder in the file explorer is marked with a background highlight only — the leftover accent bar on the left is gone

New features

• Symlinked files and folders now stand out in the file explorer. They show a link icon, read quieter than the rest of your files, and tell you exactly where they point when you hover over them
• Blockquotes can have a font, weight, and italic style of their own, set in Appearance → Typography. Quotes in your existing documents keep the look they have now until you change these
• Right-click any file in the explorer and choose “Copy path” to put its full path on the clipboard

Improvements

• The Sync and Checkpoint buttons now show a spinner while they’re working — however you started them, whether from the button, a keyboard shortcut, or the menu — and can’t be set off twice by an accidental double-click
• Updates now install the moment you click, instead of waiting for you to stop typing first. If an agent is mid-task in the terminal, Flywrite asks before restarting

Fixes

• Folders that are symlinks showed up as files in the file explorer and couldn’t be opened

Fixes

• Fixed an error (“spawn EBADF”) that could break checkpoints and sync — the buttons would disappear and every checkpoint attempt failed — in projects containing a symlinked folder or a large dependency folder (like a Python virtualenv). Flywrite no longer follows symlinks or scans dependency folders when watching your project for changes, which also makes it lighter on system resources

New features

• Smarter agent notifications: Flywrite now hooks directly into Claude Code and Codex, so you get a macOS notification the moment an agent finishes a task — and when it stops to ask for your permission or input. Set it up once per agent from Settings → General with the “Set up” button; the agent adds its own hook while you watch and approve

Improvements

• Flywrite is now signed and notarized by Apple. Installing is simply download, drag, open — no more “app is damaged” warning and no Terminal workaround — and macOS permission choices now stick across updates

Improvements

• Files an agent creates inside an ignored folder now show up in the file explorer. Expand the folder once and anything written inside it appears live, instead of staying invisible until you relaunched Flywrite
• The file explorer refreshes on its own after an agent finishes writing, and again whenever you switch back to the Flywrite window — so files created from an outside terminal or another app turn up without a relaunch

Fixes

• A settings sync conflict can no longer get stuck. Starting an agent session while a conflict was open could save a checkpoint over the half-resolved file, leaving conflict markers inside it and the resolve buttons refusing to do anything. Checkpoints and restores now wait until you've finished resolving

New features

• You can now switch checkpoints off for a project that already has version history. Project Settings → General has a Disable checkpoints button that removes version tracking from the folder — it warns you first, and your documents are left exactly as they are

Improvements

• Project Settings is simpler. The Advanced section is gone and everything lives under General, so checkpoints, hiding a project, and removing it are no longer buried in a second tab
• Explanatory text in Project Settings now reads as a small line under the setting it describes, instead of floating below a divider as if it were its own row

Fixes

• You keep your place when an agent edits the file you're reading. Flywrite used to jump you back to the top of the document on every edit; now the page holds still, and if the agent changed something you were looking at, it's brought into view just below the top edge
• The bar along the bottom of the window, with the file path and terminal button, no longer disappears when you make the terminal full height
• The terminal now resizes properly after you hide and reopen it. It used to stay stuck at its previous size, so making the panel taller just added a large blank gap under the prompt instead of showing more of your session

New features

• New files and folders now land where you're pointing. Click a folder in the file tree to make it the destination, and everything that creates a file — ⌘N, the + button above the tabs, File → New File, and the tree's own + File and + Folder buttons — creates it there. Click a file to clear the selection and go back to the top of the project
• Flywrite no longer has to turn your project folders into git repositories. It has always done this quietly so checkpoints would work everywhere, but some folders shouldn't become repositories. You can now switch it off for every project in Settings → Writing, or for one project in Project Settings → Advanced. Folders that already have a repository keep their checkpoints either way

Improvements

• Twice as many project colors to choose from, including a full row of lighter shades. Project initials automatically switch to dark text on the light colors so they stay readable

Fixes

• Right-clicking a collapsed folder and choosing New Folder now opens the folder so you can see the name box. Previously nothing appeared to happen until you expanded it yourself

New features

• Your settings now stay in sync across all your Macs on their own. Once you've connected your settings to a GitHub repo, Flywrite keeps them up to date everywhere in the background. If you changed the same setting on two Macs, it stops and shows you a warning with a button to sort it out, rather than picking one for you. Switch it off any time in Settings → General

Improvements

• Flywrite now looks for work pushed from your other Macs on its own — when you open a project, when you switch back to the app, and every few minutes while you work. You'll see what's waiting, and nothing on your screen changes until you click Sync
• The Sync button is always there on projects connected to GitHub. It used to disappear whenever Flywrite believed you were up to date, which left you no way to check for new work
• Creating a link with ⌘K now opens the address box straight away, so you can paste and carry on. Links also have a button to remove them

Fixes

• Terminal output stays at the bottom when you make the terminal panel taller, instead of jumping around
• Long words in tables no longer break apart mid-word

New features

• A new terminal button at the right end of the bottom bar opens and closes the terminal panel with one click
• Two new keyboard shortcuts: ⌘⌥C copies the current file's contents and ⌘⌥R reveals the file in Finder — both rebindable in Settings → Keyboard and available in the command palette

Improvements

• The bottom bar's line number, copy, and reveal-in-Finder buttons now sit right next to the file name instead of on the far right
• Hovering the bottom bar's buttons now shows their keyboard shortcut alongside what they do
• The empty space next to your file tabs can now be used to drag the window around

Fixes

• Keyboard shortcuts that use the Option key with a letter (like ⌥⌘B to toggle the sidebar) now work — pressing them previously did nothing

New features

• Maximize the terminal — a new chevron in the terminal bar expands the panel to fill the window (your file tabs stay visible), and when it's maximized a minus button drops it back to half height

Improvements

• Dragging the terminal panel's top edge now goes all the way to the top of the window — it used to stop about 80% of the way up
• The Appearance settings page gives more room to the live theme preview, with tidier labels

Fixes

• Switching projects no longer shows the previous project's terminal in the panel

Fixes

• No more repeated “Flywrite would like to access the microphone” pop-ups on macOS — the chime that plays when Claude finishes now goes through Notification Center, which never touches the microphone. The chime also respects your macOS notification and Focus settings now

New features

• Add images to your writing — paste a screenshot, drag an image file into the editor, or click the new Img button in the formatting toolbar, and the picture appears right in your document
• Choose where images are kept in Settings → General: one top-level images folder for the whole project, or an images folder next to each document — Flywrite creates the folder the first time you need it and reuses one that already exists
• Drag files or folders from Finder into the file explorer to move them into your project, including into any subfolder — hold Option to copy instead of move
• Reorder your projects by dragging them up or down in the projects sidebar

Improvements

• Flywrite remembers your window's size and position, so it opens right where you left it
• Right-click any folder in the file explorer to open it in Finder
• Images in your documents refresh automatically when the file changes on disk, and show a small placeholder if the file is missing
• Headings and bold text now render in a brighter color that makes them pop above body text — a new customizable "Bright text" color in every theme — and inline code is colored to match your theme's code style
• A slimmer highlight ring marks the active project in the projects sidebar

Improvements

• Folders excluded by your project's .gitignore (build output, dependencies, and the like) now load their contents on demand when you expand them, instead of being scanned up front — large projects open in a snap

Fixes

• Opening a large codebase no longer hangs the app for minutes or crashes it with "too many open files" errors — Flywrite no longer watches inside gitignored folders, while files you open from them are still monitored for outside changes
• Removed the unnecessary macOS prompt asking for microphone access — Flywrite never uses the microphone, camera, or screen recording

New features

• Expand or collapse every folder in the file explorer at once — new buttons at the top of the file list, with keyboard shortcuts (⌃⇧↓ to expand, ⌃⇧↑ to collapse)
• Checkpoints link to GitHub — when your project is connected to a GitHub repo, click any checkpoint name in the Versions panel to view that commit on github.com
• New keyboard shortcuts: ⇧⌘J focuses the editor (the counterpart to ⌘J for the terminal), and ⌘/ jumps straight to keyboard shortcut settings with the search box ready to type

Improvements

• When more tabs are open than fit across the window, the tab bar scrolls smoothly with no scrollbar — the active tab always stays in view, and edge shadows show when more tabs are tucked away to either side (file tabs and terminal tabs both)
• Files that match your project's .gitignore appear dimmed in the file explorer, so your tracked work stands out
• The Versions bar responds to hover like a button, making it clearer you can click to expand it

New features

• View images right in the editor — click any .png, .jpg, .gif, .webp, or .svg in your project and it opens as a picture, with zoom controls (fit-to-window up to 800%) and scrolling when you zoom past the window
• Play videos and audio files in the editor too — .mp4 and .mov videos get a player with seeking, and audio files like .mp3 and .wav get playback controls
• Media files refresh automatically when they change on disk — handy when an AI agent generates or updates an image while you watch

Improvements

• The editor's find & replace bar looks cleaner — better spacing between the search and replace rows, checkboxes that line up with their labels, and buttons that match the height of the input fields
• Property names and values in the document properties panel now line up neatly, even when a property has a long name

Fixes

• Terminal history is no longer wiped while AI agents like Claude Code are running — you can now scroll back through earlier output, and making the terminal panel taller reveals more history instead of empty space

New features

• Switch projects from the keyboard — press ⌥⌘↑ / ⌥⌘↓ to cycle through your projects, or type "Go to Project" in the command palette to jump to any project by name

Fixes

• Terminals launch again — version 0.4.8 shipped with a bug that prevented any terminal from opening (a "posix_spawnp failed" error); updating fixes it
• The terminal panel can now take focus even when it has no terminals — click anywhere in it or press your Focus Terminal shortcut, and your new-terminal shortcuts work from there
• Info tips in Settings are no longer cut off at the edges of the panel
• The numbers on terminal launcher shortcuts are now properly centered

New features

• Edit your settings as files — click "Edit settings file (JSON)" in Settings and a special Settings project opens in your projects list, with your settings and custom themes as editable files, complete with the same checkpoints and version history as any project
• Settings changes apply instantly — edits to your settings files take effect the moment they're saved, no restart needed
• Let your AI agent manage your settings — open a terminal in the Settings project and ask Claude Code (or another CLI agent) to tweak your fonts, theme, or shortcuts; the app updates live as it works
• Sync your settings across Macs — connect the Settings project to a private GitHub repo and pull the same setup onto your other Mac. A local overrides file lets you keep certain settings device-specific

Improvements

• Font pickers now list every font installed on your Mac, searchable, with the code and terminal pickers filtered to monospaced fonts
• A live preview in Appearance settings shows how your font and theme choices will look as you make them
• Small "i" info tips throughout Settings explain what each option does
• If a project's folder is deleted, moved, or renamed outside Flywrite, the app now flags it and offers to locate the folder, re-clone it from GitHub, or remove the project
• Arrows in rendered documents display with cleaner glyphs

New features

• Line numbers in the editor: a new "Show line numbers" setting (Settings → Appearance → Typography, on by default) adds a line-number gutter to code files and markdown source view, plus a current-line readout in the status bar
• Links in markdown documents now render as clean styled text — click a link to see its URL, open it in your browser, or edit it in place
• The terminal's + button now opens a menu of all your terminal launchers with their keyboard shortcuts, so you can start any launcher without changing your default
• Themes can now set a custom terminal text color alongside the terminal background — or leave both on "auto" to follow the theme

Improvements

• Every color in the theme builder now has a reset button — colors reset back to the theme you started from, and terminal colors clear back to auto
• Typing -> or <- in a markdown document displays as a real arrow (the original text reappears when you select it)
• The formatting menu now highlights the buttons for formatting the selected text already has
• The terminal tab bar adapts its colors to a custom terminal background so tab titles stay readable

Fixes

• Pasting from apps that only provide rich text (some email clients and browser copies) no longer pastes nothing — the content is converted to plain markdown-style text

Improvements

• The update button now stays in the top bar until you act on it, and has a small × to dismiss it — "Check for Updates…" brings it back

Fixes

• Clicking "Update & restart" now actually installs the update and relaunches the app. Because the fix is in the app itself, updating from 0.4.5 or below requires one last manual re-download from your account.

New features

• Formatting keyboard shortcuts in the editor: ⌘B bold, ⌘I italic, ⌘K to insert a link, and ⇧⌘7 / ⇧⌘8 / ⇧⌘9 to toggle bullet, numbered, and checkbox lists — all customizable in Settings → Keyboard, with a matching Format menu in the menu bar
• Pick a custom terminal background color in the theme builder, with separate light and dark values — terminal text automatically stays readable on any background you choose
• Every settings page now has a "Reset to defaults…" button that resets just that page (with a confirmation first)

Improvements

• New files created without an extension now default to Markdown, so "notes" becomes notes.md
• To make room for Bold and Insert Link, two default shortcuts moved: Toggle Right Sidebar is now ⌥⌘B and the Command Palette is ⇧⌘P (both can be changed back in Settings → Keyboard)

Fixes

• When typing an empty heading (like "##"), the cursor now sits exactly where your text will appear instead of drifting into the left margin

New features

• Delete a project right from its right-click menu — Flywrite asks for confirmation, and your files always stay safe on disk

Improvements

• Flywrite now checks for updates the moment it launches
• When an update is ready, a prominent "Update & restart" button now appears in the top bar — one click installs the update (or queues it until your agents finish working)
• After you check for updates manually, Flywrite now notifies you when the download is ready to install

Fixes

• Fixed an issue where the update button could fail to appear after an update was found during launch

Improvements

• Flywrite now runs on Intel-based Macs as well as Apple Silicon — the app ships as a single universal build

Improvements

• The Help menu now has quick links to Documentation, Release Notes, and Get Support
• The Help menu links straight to managing your license — or activating one if you haven't yet
• The welcome screen now shows the Flywrite icon
• The About window shows the icon at full size, links to the release notes, and no longer has extra empty space at the bottom

Fixes

• The app icon now matches the standard macOS icon size and shape, so it no longer looks oversized in the Dock and Cmd-Tab app switcher

Flywrite's first release with a public changelog! Flywrite is a local-first writing environment for content creators: select text in your document, talk to Claude Code in the built-in terminal, and the agent edits your files while you review what changed. Projects are plain folders of markdown on your Mac — with automatic checkpoints, one-click restore of earlier versions, optional GitHub sync between Macs, rebindable shortcuts, themes, and per-file display settings.

New features

• Updating is now one click — Flywrite restarts right away, or if an agent is still working in a terminal, the update installs itself as soon as everything goes idle
• Switch between terminal tabs with Ctrl-Tab and Ctrl-Shift-Tab — the same shortcuts you already use for file tabs
• Create a new file straight from the tab bar with the new + button

Improvements

• An editor command and a terminal command can now share the same keyboard shortcut — whichever pane has keyboard focus decides which one runs
• The tab bars now highlight which pane your shared shortcuts will act on
• New-terminal shortcuts no longer fire while you're typing outside the terminal
• A larger set of project colors to pick from, arranged as a spectrum

Licensing, activation, and auto-update support.