Skip to content

Releases: Shpigford/clearly

Clearly v2.8.0

28 Apr 14:43

Choose a tag to compare

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

Clearly v2.7.0

27 Apr 19:27

Choose a tag to compare

  • 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

Clearly v2.6.1

27 Apr 14:45

Choose a tag to compare

  • Settings and preferences now carry over correctly when upgrading from v2.5.0

Clearly v2.5.0

24 Apr 18:50

Choose a tag to compare

  • 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

Clearly v2.4.0

23 Apr 16:31

Choose a tag to compare

  • 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

Clearly v2.3.0

20 Apr 16:51

Choose a tag to compare

  • 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

Clearly v2.2.0

16 Apr 15:01

Choose a tag to compare

  • 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

Clearly v2.1.0

15 Apr 18:56

Choose a tag to compare

  • 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

Clearly v2.0.0

14 Apr 17:52

Choose a tag to compare

  • 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

Clearly v1.16.0

13 Apr 00:49

Choose a tag to compare

  • Redesigned UI with refined sidebar, toolbar, and file explorer styling