Changelog.

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 .dmg instead of a bare disk image.
• Released for free during public beta. Early users keep free access; pricing comes later.

The "type a title and have it just work" flow is one of the most-touched paths in the app. Three rounds of debugging to get it right — first I thought it was a save-locks-input race, then I thought it was the filename rename interfering, finally it turned out to be a doc:new + doc:select double-mount. Worth every minute.
— Kirill

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).