Typing no longer gets replaced by an older copy.
A change to the file could reload the document you were typing and drop the last few words. The editor now keeps what you have typed. Once that is saved, an update from an agent still shows up.
Changelog.
Every update to FolderMD, documented. New features, fixes, and small improvements to the reader for what your agents write.
A new document stays editable.
Opening a document and typing a few words locked it into a read-only view. Closing and reopening was the only way back. The first open no longer does that, and the save stays in the editor.
Closing Notes no longer leaves scrollbars behind.
Closing the notes column left the document scrolling inside itself. The column now closes clean, and a long line in a code block wraps instead of growing a second scrollbar.
Notes on a sentence, ready to paste back.
A note on the selection.
Select text and click Note. Write what you want done with that passage. The note is saved beside the file, and it is still there the next time you open the document.
Copy for AI.
The button at the bottom of the notes panel copies a paste: the file path, the heading and paragraph around the selection, and each note. Paste that to the agent. FolderMD does not send it.
Quieter checkboxes.
The sidebar checkboxes sit on the right of each row, and they appear when you hover. A selected document stays highlighted.
The website caught up with the app.
The download page is quiet on purpose. One headline, the app, and a button. The longer explanation moved to Why, so the front door is no longer an essay.
The looping “your agent is working” animation is gone. In its place is a still of the real window: the agent writes a file into the folder, you edit a sentence, and that same file is what the agent reads next.
The page itself is lighter. White, heavy type, one green word. Under the download button it now says: pay it forward with good will and happy vibes.
A new document, a marked sentence, a cleaner sidebar.
New document.
The + in the toolbar starts a document. So does ⌘N.
Highlight, and keep it.
Select some text and press H on the floating toolbar, or type ==like this==. The file on disk keeps that syntax, and a save no longer eats the highlight. This landed in the June builds (0.1.5) and is in the download now.
Select more, then Trash.
Check a document, a whole day or project, or Select all (⌘A). Delete moves them to Trash. Restore is still there when you open Trash.
The sidebar finally understands what you're trying to do.
The biggest change in this release is a complete rethink of how the sidebar organizes the documents your agents produce. It now works the way a human who reviews a lot of AI output actually thinks.
Time first, then project.
Everything is now grouped under clear time buckets at the top level: Today, Yesterday, This Week, and Older. Inside each bucket the documents are further clustered by the project they came from (e.g. "Postal", "foldermd", "A2PDF", or "Inbox" for global notes).
This means the most recent agent work is always visible and scannable without scrolling through a long flat list.
Foldable outline view.
Both the time periods and the individual project groups are now fully collapsible, with disclosure triangles and proper indentation — very much in the spirit of a good code outline or file tree (think Zed or Finder list view). Your collapse/expand choices are remembered across restarts.
Bulk cleanup that feels native.
You can now select multiple documents the way you expect on a Mac:
- Cmd/Ctrl-click to pick individual items (even across different projects or days)
- Shift-click to select a contiguous range
As soon as anything is selected, a compact action bar appears at the top of the sidebar with Unpin and Delete buttons. Perfect for quickly clearing out the design docs and implementation plans you're done with.
One more tiny thing that helps every day.
Next to the file path at the bottom of the reader there's now a small copy icon (⎘). Click it and the full absolute path is in your clipboard — exactly what you want when you need to tell an agent "go read and improve this specific document."
Title editing that doesn't fight you.
The first real round of polish on the writing experience. Creating a new document and typing the title is now the simple thing it should always have been — and the file on disk does the right thing without you ever having to think about it.
The title race, fixed.
New documents used to lose your first few keystrokes if you typed into the H1 too quickly. The inbox watcher emitted a redundant doc:new event ~250 ms after creation, the frontend tore down and rebuilt the editor, and whatever you'd typed in that window vanished along with the focus. The handler is now stricter — it auto-opens a doc only when nothing else is active. No more remount mid-edit.
One-time slug rename.
New files are created as <timestamp>-untitled.md. The first time you save with a real H1, the file is renamed once to <timestamp>-<slug>.md. After that, editing the heading further never touches the filename — no churn, no broken paths, no surprises in git status. Both the old and new paths are marked as self-writes before the OS rename fires, so the editor never re-mounts under you.
Click and type.
Opening a freshly-created document now pre-selects the word Untitled in the H1, so the first keystroke replaces it. Old behaviour: click in the middle of "Untitled", type "Plan", end up with "UntPlanitled". New behaviour: click + type "Plan", you get "Plan".
Live sidebar title.
The sidebar entry, the toolbar's title chrome, and the macOS window title now reflect what you type into the H1 in real time. No waiting for a save round trip, no waiting for the watcher to notice. Everything updates as your fingers move.
Smaller things.
- The editor auto-focuses when a document opens — no need to click into the pane first.
- The marketing site now ships the standard "drag-to-Applications" install UI on the
.dmginstead of a bare disk image. - Released for free during public beta. Early users keep free access; pricing comes later.
FolderMD is a thing now.
The first version of FolderMD. A small Mac app that watches a folder and renders the markdown documents your AI agents drop into it, beautifully — and gives you a real keyboard to read, edit, and write them with.
A folder is the interface.
Point any agent — Claude Code, Codex, Cursor, Aider, Windsurf — at the inbox folder. Every markdown file dropped there is picked up within milliseconds, typeset, hyphenated, syntax-highlighted, mermaid-diagrammed, ready to read.
Project work lands in a .foldermd/ folder at the repo root — gitignore-able, shareable, or committable. Anything not tied to a project goes to a global inbox at ~/Library/Application Support/foldermd/inbox/. The two destinations work invisibly; you never have to think about the path.
Reads like a book.
IBM Plex Serif for the body. JetBrains Mono for code. Optical-size hyphenation. Generous measure. Light and dark mode, depending on your system. Syntax highlighting that picks two colours and stops there — comments dim, strings italic, the rest left to the typography.
Writes like one, too.
You can read, edit, or compose markdown documents from scratch. Drag a folder of notes onto the icon and use it as a reading room. Open any .md file with ⌘O. Save with ⌘S. Files are always plain markdown on disk — the same files your editor opens, the same files Git tracks.
A small CLI helper.
A foldermd command-line helper ships in the menu bar. Pipe any markdown into it from a shell or an agent script, and the document opens in FolderMD with a clean filename and timestamp. The helper also installs routing rules into the config files your agents already read — CLAUDE.md, .cursorrules, .aider.conf.yml, and friends — so you don't have to wire anything up by hand.
What it deliberately isn't.
Not a code documentation generator. Not an AI app. No chat panel, no model picker, no account, no telemetry. The agents you already pay for write to a folder; FolderMD gives those documents a real home and gives you a keyboard to work with them.
Specs.
- macOS 13 or later, Apple Silicon and Intel.
- ~3 MB download, signed and notarised, delivered as a
.dmg. - One-time license at $10 (free during public beta — early users keep free access).