Changelog

Everything that's shipped in Clearly — Mac and iPad, newest first.

Mac

v3.1.2

2026-05-15
  • Double-clicking text in Preview no longer kicks you back to Edit mode — word selection works as expected
  • Dead-key composition (e.g. typing accented characters) no longer silently drops mid-typed input
Mac

v3.1.1

2026-05-13
  • Scratchpad shortcut no longer steals focus from the app you were using
  • Scratchpad title no longer overlaps the traffic-light buttons
iOS

v2.0.0

2026-05-12
  • Refocused as a clean, distraction-free markdown editor — the vault sidebar, full-text search, quick switcher, backlinks, outline, and tags surfaces have been removed in favor of the system document browser
  • Tapping a .md in Files.app now shows a rendered preview (math, mermaid, syntax highlighting) instead of raw text
  • Files icon view shows a real thumbnail with the document's first heading and body lines
  • Restored .md routing so opening from Mail, Safari, or any other app hands off to Clearly
Mac

v3.1.0

2026-05-12
  • Scratchpad now keeps a persistent history in a single floating window — closing won't lose work, and you can browse past notes from the title dropdown (search, ⌘N for new, ⌘P for history, ⌫ to delete with undo)
  • New Settings → Scratchpads tab with retention controls (keep all, delete after N days, or keep newest N)
  • New "Default View Mode" setting in Settings → General to open documents directly in Preview
  • "Keep running in menu bar" setting restores menubar-only mode — ⌘Q and closing the last window drop the app to the menubar instead of quitting
Mac

v3.0.1

2026-05-08
  • Restored QuickLook previews and the default-opener behavior for .md files in Finder
Mac

v3.0.0

2026-05-08
  • Clearly is now a focused, distraction-free markdown editor — vault index, chat, wiki, and CLI/MCP integrations have been removed
  • New hover-revealed bottom toolbar with a Copy menu, styled with Liquid Glass
Mac

v2.13.0

2026-05-04
  • Customize each vault folder's icon and tint color in the sidebar
  • Optional status bar shows live word and character counts
  • Rename files and folders inline from the sidebar context menu
  • Delete files and folders directly from the sidebar context menu
  • Recents drops files that no longer exist on disk at launch and on app activation
  • Confirm before discarding unsaved changes when navigating to another note
  • Last-used view mode (Editor / Preview) is now remembered across notes and launches
  • Removed the floating formatting toolbar from the experimental WYSIWYG mode
  • Removed the experimental LLM Wiki feature (vault chat remains)
Mac

v2.12.0

2026-05-01
  • Fixed runaway memory and CPU usage when indexing large vaults
  • Adding a folder that's already inside (or contains) an existing vault is now blocked
Mac

v2.11.1

2026-05-01
  • New notes (⌘N) start blank instead of carrying over the previous note's content in the editable preview
Mac

v2.11.0

2026-05-01
  • Experimental WYSIWYG preview — type directly in the rendered view. Enable it in Settings.
iOS

v1.4.0

2026-04-29
  • Find + Replace across the editor, with stale-highlight fix
  • Fold and unfold code blocks in Preview and Live Preview
Mac

v2.10.0

2026-04-29
  • Find + Replace across the editor, with stale-highlight fix
  • Fold and unfold code blocks in Preview and Live Preview
  • Hide Toolbar (⌥⌘T) for distraction-free writing
  • ⌘P recents show their parent folder, and same-name tabs are disambiguated
  • New CLI/MCP capabilities: vault status, search operators, find_related, move_note, plus public docs
  • Pasting screenshots from the system clipboard now works reliably
  • Fixed a crash when removing a vault folder from the sidebar context menu
  • Better compatibility with the latest Claude CLI versions
iOS

v1.3.0

2026-04-28
  • Long-press a file in the sidebar for Move, Duplicate, Share, and inline Rename
  • Click any mermaid diagram in preview to zoom it full-screen
  • Pasting a URL now keeps it as a link instead of failing an image download
  • Hardened large-file handling to keep memory in check when opening big notes
Mac

v2.9.0

2026-04-28
  • Click any mermaid diagram in preview to zoom it full-screen
  • ⌘⇧T toggles a todo on the current line, with consistent prefix handling across formats
  • Detects Claude and Codex CLIs installed via nvm so you don't need to fix PATH manually
  • Pasting a URL now keeps it as a link instead of failing an image download
  • Hardened large-file handling to keep memory in check when opening big notes
Mac

v2.8.0

2026-04-28
  • Chat panel works in every vault now — no longer limited to LLM Wikis. A vault picker in the chat toolbar makes the active vault explicit for multi-vault users.
  • Smarter chat retrieval finds notes by title and section even when the question doesn't quote the exact words (e.g. "summarize my writing on local-first software" now matches the note literally named that).
  • Chat citations show the heading path so you can see which section answered.
  • Drop a new note into an LLM Wiki and Clearly proposes where to file it and which related notes should link to it — same diff-sheet review as Capture and Review. Notes are never moved from where you dropped them.
iOS

v1.2.0

2026-04-27
  • New unified sidebar showing files and folders inline, mirroring the Mac layout
  • Vault picker no longer flashes briefly when the app launches
Mac

v2.7.0

2026-04-27
  • New experimental live preview editor — WYSIWYG-style markdown editing
  • Sidebar context menu now offers Copy Path, Relative Path, and Wiki Link
  • Preview outline navigation scrolls reliably and no longer leaves stray highlights after switching back to edit mode
  • ⌘W now correctly closes the Settings window when open, instead of the active document
Mac

v2.6.1

2026-04-27
  • Settings and preferences now carry over correctly when upgrading from v2.5.0
Mac

v2.6.0

2026-04-27
  • LLM Wiki vaults — turn any folder into an AI-curated knowledge base with AGENTS.md, index.md, and log.md
  • Capture (⌃⌘I): paste a URL or text and the agent files it as new notes
  • Chat (⌃⌘A): ask questions about your vault with semantic retrieval and cited sources; "File as Note" for keepers
  • Review: runs once a day to propose tidy-ups; "Review ready" badge above the log sidebar
  • Diff-review sheet on every agent-proposed change — accept or reject per file before anything lands
  • Log timeline sidebar (⌃⌘T) shows every accepted operation with timestamp, kind, and changed files
  • Powered by your local Claude Code or Codex CLI subscription — no API key, no extra billing
  • Settings → Wiki tab to pick a runner and see install status
  • File → New LLM Wiki seeds a fresh vault; right-click any vault for Convert to LLM Wiki…
  • Sidebar marks wiki vaults with a book icon and WIKI badge
  • Clickable [[wiki-links]] in chat answers
  • New `semantic_search` MCP tool for embedding-based retrieval from any agent
  • Marketing site links now show a preview image when shared
iOS

v1.1.0

2026-04-24
  • Paste and drop images directly into the editor
  • Public changelog page with in-app links
  • Fixed inline LaTeX rendering on dollar-sign currency amounts
Mac

v2.5.0

2026-04-24
  • Paste and drop images directly into the editor
  • Drag and drop files and folders in the sidebar to reorganize
  • Adjust sidebar text size in Settings
  • New setting to hide the menu bar icon
  • CLI install no longer needs sudo or Terminal — installs to ~/.local/bin
  • Recoverable CLI install flow with clearer diagnostics
  • Public changelog page with in-app links
  • Fixed pasted text disappearing in the editor until you scrolled
  • Fixed ⌘+H removing the Dock icon instead of hiding windows
  • Fixed third-party cloud folders being labeled as iCloud in Sync settings
  • Fixed Settings not coming to the front when opened from the menu bar icon
  • Fixed inline LaTeX rendering on dollar-sign currency amounts
Mac

v2.4.0

2026-04-23
  • Native macOS shell: two-column NavigationSplitView with folder tree + detail pane
  • Sidebar inherits your System Settings accent color (like Finder)
  • New Recents and Tags sections in the sidebar
  • Customize each folder's icon and color; nested files inherit the look
  • ⌘-click a sidebar row to open the note in a new tab
  • New Copy menu in the toolbar: copy path, filename, markdown, HTML, RTF, or plain text
  • Sample Document now opens an editable copy of the demo instead of a blank file
  • File → Open Recent lists recently opened documents
  • Window title shows the active document name, with a dot when unsaved
  • Sync Settings labels vault locations by capability (iCloud, Desktop & Documents, local-only)
  • Minimum macOS raised to Sequoia 15 so Clearly picks up Liquid Glass on macOS 26 automatically
iOS

v1.0.0

2026-04-22
  • Initial iOS/iPadOS TestFlight release
  • Browse your iCloud vault with a folder-based sidebar, same vault as the Mac app
  • Syntax-highlighted markdown editor with coordinated writes and autosave
  • Preview mode with wiki-link navigation
  • FTS5-backed full-text search and Cmd+K quick switcher
  • Backlinks, outline, and tags surfaces for the current note
  • iCloud conflict detection with a sibling-file diff view
  • iPad 3-column split view with a multi-document tab bar
  • Sync settings surface for iCloud status and controls
Mac

v2.3.0

2026-04-20
  • `clearly` command-line tool shipped — install from Settings → Command Line for terminal and MCP-client access to your vault
  • MCP server grows from 3 to 9 tools: `read_note`, `list_notes`, `get_headings`, `get_frontmatter` (reads) plus `create_note`, `update_note` (writes)
  • Structured JSON on every tool, input/output schemas published via MCP, stable error identifiers
  • Agent-friendly `--help` with examples on every CLI subcommand
  • XCTest integration suite drives every MCP tool end-to-end on every PR
  • `ClearlyMCP` target renamed to `ClearlyCLI` internally (same bundled binary, new subcommand tree)
  • New Command Line tab in Settings replaces the MCP Config tab
Mac

v2.2.0

2026-04-16
  • Hide frontmatter in preview mode with a new toggle in Settings
  • Empty folders now appear in the sidebar file tree
  • Drag the window from the top of preview mode
  • Sidebar width persists correctly on macOS 15
  • MCP server config now points to the correct binary
  • Opening a scratchpad no longer brings the main workspace window forward
  • Sparkle update checks disabled in debug builds
Mac

v2.1.0

2026-04-15
  • Pin favorite documents to the top of the sidebar for quick access
  • Set a preferred content width for comfortable reading on wide displays
  • Welcome view with a Getting Started guide greets new users on first launch
  • Middle-click a tab to close it
  • Toggle the Go to Line and Find bars open/closed with their keyboard shortcuts
  • Selected text stays highlighted when switching between editor and preview
  • Sidebar remembers its width between app restarts
  • Editor stays responsive on large markdown files
  • Sidebar and vault index skip heavy directories and respect .gitignore
  • Window controls stay accessible when the sidebar and tab bar are hidden
  • Location bookmarks validate directory access on restore
Mac

v2.0.0

2026-04-14
  • Open multiple documents in tabs (Cmd+T, Cmd+W, Cmd+Shift+[/] to switch)
  • Link between notes with [[wiki-link]] syntax and auto-complete as you type
  • Find any note instantly with Quick Switcher (Cmd+P) and full-text content search
  • See which notes link to the current one in the Backlinks panel, with one-click Link for unlinked mentions
  • Browse your #tags from the sidebar, with highlighting in both editor and preview
  • Expose your vault to AI agents through the bundled MCP server
  • Line numbers in the editor with jump-to-line
  • Pick a preview font: San Francisco, New York, or SF Mono
  • Redesigned marketing site and overhauled demo document
  • Large vaults no longer freeze the app while loading
  • Fullscreen windows now have correct sidebar and content spacing
  • Export PDF and Print work again after the multi-file redesign
  • Typing is smooth again on long documents
  • Preview cursor no longer leaks into editor mode
  • Polished code blocks: copy button, rounded corners, proper gutter width
  • Frontmatter tags register correctly alongside inline #tags
Mac

v1.16.0

2026-04-12
  • Redesigned UI with refined sidebar, toolbar, and file explorer styling
Mac

v1.15.0

2026-04-11
  • Tables get captions, sortable columns, sticky headers, and a copy-as-TSV button
  • Code blocks get syntax highlighting for 27+ languages, line numbers, diff highlighting, and filename headers
  • Highlight text with ==marks==, write super^script^ and sub~script~, and use :emoji: shortcodes
  • 15 types of callouts and admonitions, with foldable support
  • Auto-generated table of contents with [TOC]
  • Click any preview element to jump to its source, toggle task checkboxes inline, and view images in a lightbox
  • Heading anchor links and footnote popovers
  • Sample Document available under the Help menu
  • Now licensed under FSL-1.1-MIT (converts to MIT after two years)
Mac

v1.14.0

2026-04-10
  • Clear your recent files list with one click from the sidebar
  • Show or hide hidden files in the file explorer
  • Copy files and folders from the toolbar or sidebar right-click menu
Mac

v1.13.1

2026-04-09
  • Fresh app icon and menubar icon
Mac

v1.13.0

2026-04-08
  • Create new untitled documents without saving them first
  • Bold and bold-italic text now renders visually in the editor instead of just showing markers
  • Pick custom icons for folders in the sidebar
  • Compact file explorer rows and refined sidebar layout for easier scanning
Mac

v1.12.0

2026-04-08
  • File explorer sidebar shows favorite locations and recent files for quick navigation
Mac

v1.11.0

2026-04-07
  • Editor and preview now toggle in place at the same scroll position, replacing side-by-side mode
  • Copy code blocks in preview with a one-click button
  • Cursor stays put when typing quickly in the editor
  • Save scratchpad notes to a file with Cmd+S
  • Cmd+Q no longer quits the app when only scratchpads are open
Mac

v1.10.1

2026-04-03
  • New documents open in front instead of behind existing windows
  • Outline panel no longer overlaps the preview in side-by-side mode
Mac

v1.10.0

2026-04-02
  • Document outline panel lets you jump to any heading with a click
  • Native spell checking with persistent preferences for each document
  • PDF export handles page breaks correctly instead of slicing content mid-line
  • Cmd+Q closes all windows instead of force-quitting, so unsaved work isn't lost
  • Editor no longer jumps when typing near the bottom of the window
Mac

v1.9.0

2026-03-30
  • Scratchpad: a menubar app with a global hotkey for capturing quick notes without opening a full document
  • Inline Find bar replaces the broken system Find panel for searching within documents
  • Window size and position are remembered per document
  • Pasting rich text no longer mangles your markdown
  • Opening multiple documents no longer hangs when scroll sync is active
Mac

v1.8.0

2026-03-29
  • Preview content uses the full window width for easier reading
  • Documents automatically refresh when modified by another app
Mac

v1.7.4

2026-03-27
  • Opening multiple documents no longer freezes the editor when scroll sync is active
  • Faster syntax highlighting for documents with frontmatter
Mac

v1.7.3

2026-03-26
  • Opening multiple documents at once no longer causes the app to hang
  • Appearance setting correctly applies your chosen light or dark mode
Mac

v1.7.2

2026-03-26
  • Diagnostic logs now survive force-quit and include previous session entries
  • Faster document opening with fewer redundant highlighting passes
Mac

v1.7.1

2026-03-25
  • Fixed a hang that could occur when opening multiple documents at once
  • Export diagnostic logs from the Help menu for easier troubleshooting
Mac

v1.7.0

2026-03-24
  • Fixed a Gatekeeper warning when opening markdown files by double-clicking
  • Now available on the App Store in addition to direct download
Mac

v1.6.1

2026-03-23
  • Markdown files are no longer greyed out in the Open panel on some systems
Mac

v1.6.0

2026-03-23
  • Frontmatter blocks (title, date, tags) are formatted in the editor and rendered cleanly in preview
  • Markdown file links are clickable in preview mode — click to open linked documents
  • Math expressions now use bundled KaTeX for faster, offline rendering
  • The Open Recent menu shows full file paths so you can tell apart files with the same name
  • Text and cursor are vertically centered within editor lines for better readability
  • New styled DMG installer with drag-to-Applications support
Mac

v1.5.0

2026-03-21
  • Paste images directly into the editor — they're saved alongside your document and render in preview
  • Fixed markdown files not opening correctly from some apps due to a non-standard file type declaration
Mac

v1.4.0

2026-03-20
  • Right-click to bold, italic, or format selected text
  • Math expressions render in preview using LaTeX syntax
  • QuickLook previews in Finder's column view use a smaller, better-fitting font
Mac

v1.3.0

2026-03-20
  • Export your documents as PDF or send them to a printer
  • Mermaid diagrams now render in preview mode
  • Markdown files open correctly from Finder and other apps
Mac

v1.2.1

2026-03-19
  • Fixed auto-update failing with "error launching the installer"
Mac

v1.2.0

2026-03-19
  • Your preferred view mode (editor, preview, or side-by-side) is now remembered across sessions
  • Editor and preview scroll together so you always see what you're editing
  • Dark mode app icon no longer shows white corners
  • Adjust font size with Cmd+ and Cmd- keyboard shortcuts
  • Automatic update support via Sparkle
Mac

v1.1.2

2026-03-18
  • Fixed an issue that prevented auto-updates from installing correctly
Mac

v1.1.1

2026-03-18
  • Fixed an issue that prevented auto-updates from installing correctly
Mac

v1.1.0

2026-03-18
  • New side-by-side view mode lets you edit and preview simultaneously
  • Code blocks in dark mode preview are now readable
  • Broken or relative images show a placeholder instead of nothing
Mac

v1.0.0

2026-03-18
  • Initial release