Changelog

New Features

• Browser-style window tabs — Desktop (macOS). Open notes and tasks as native macOS tabs. Use ⌘T for a new tab, the tab bar’s ”+” button, or “Open in new tab” from the context menu; tabs are restored on relaunch.
• Back / forward navigation — Desktop. New back and forward buttons in the breadcrumb bar let you retrace where you’ve been.
• Duplicate a task — Desktop. Added a context-menu option to duplicate a task.
• Copy ID — Desktop. Added a context-menu option to copy a note or task ID.
• Collapsed-heading copy/cut — Desktop. Copying or cutting a collapsed heading now includes its hidden content.
• Export to DOCX — CLI & MCP. Export notes to Word (.docx).
• shortcuts:// links — Desktop (macOS). NoteCove now supports shortcuts:// links, including driving the “find note by title” Shortcuts action from a variable.
• Homebrew install — Desktop (macOS). NoteCove can now be installed via Homebrew.
• More reliable notecove serve — CLI. Auto-reconnecting tunnel (SSH keepalives) so a dropped connection recovers on its own.
• More noticeable Pomodoro end — Desktop. The end of a Pomodoro session is now more conspicuous.

Bug Fixes

• PDF attachments — Desktop. Fixed PDF preview and export, which had stopped working.
• Attachment size via CLI — CLI. Attachment uploads now respect the configured max file size instead of a 1 MB cap.
• Markdown attachments — Desktop. Attaching a .md file now works.
• Semantic search — Desktop. Fixed semantic search.
• Heading backlinks — Desktop. Links to a heading within a note now count as backlinks.
• Live folder updates — Desktop. Folder changes now update live instead of requiring a refresh.
• Find-in-note scrolling — Desktop. On long notes, finding text near the bottom no longer scrolls the breadcrumb bar off screen.
• Single-window breadcrumbs — Desktop. Single note/task windows now show the breadcrumb bar.
• Notes-list snippets — Desktop. Links in note-list snippets no longer show the raw ID.
• Search result IDs — CLI. Text search now returns the full ID (except where a project slug applies).
• Account display name — Fixed NoteCove showing the wrong account display name.
• Main-window crash — Desktop. Fixed a crash in the main window.
• Page reload shortcuts — Desktop. ⌘R / ⇧⌘R no longer reload the app unexpectedly.
• Multiple task types on create — iOS. The iOS app now supports multiple types when creating a task.
• Link chips — iOS. Link chips now display correctly.

New Features

• Note widget — Add a home screen widget to quickly create a new note without opening the app.
• Smart Folders CLI — Manage smart folders from the command line with full create, list, edit, and delete support.

Enhancements

• Improved spell check — More accurate and less intrusive spell checking across notes.
• Improved Nearby Sync — More reliable peer discovery and connection when syncing with nearby devices.
• CLI: infer storage directory from parent folder — folder create --parent now automatically selects the correct storage directory, so you don’t need to pass --sd separately.

Bug Fixes

• Links in headings render as plain text — Links inside headings no longer appear as chips or trigger unfurl previews.
• Nearby Sync panel opens correctly — The Tools > Nearby Sync menu item now reliably opens the sync panel.
• Mobile note loading — Fixed an issue where a note would fail to load on mobile even though it opened fine on desktop.
• Widget: note opens reliably — Tapping the widget to open a note no longer occasionally fails to navigate to the note.
• CLI: cross-storage-device move rejected — folder move now correctly rejects attempts to move a folder across storage device boundaries via the CLI.
• CLI: note folder update handles storage device change — note edit --folder now correctly updates the storage device ID when moving a note to a folder on a different storage device.
• Nightly builds no longer auto-downgrade — Nightly builds would revert to the stable release on restart; this is now fixed.

New Features

• Nearby Sync — Devices on the same local network now sync notes directly with each other via Multipeer Connectivity, without waiting for iCloud. When nearby peers are available, changes propagate in seconds rather than minutes.
• Apple Shortcuts & Siri — NoteCove actions are now available in the Shortcuts app and via Siri on both macOS and iOS. Automate note creation, search, and more from any app or voice command.
• Kanban subtree filtering — Filtering the Kanban board by a parent task now shows only that task’s subtree, making it easier to focus on a specific feature or epic. Works on both desktop and iOS.
• CLI: auto-derive storage space from folder — The notecove CLI can now infer which storage space a folder belongs to, so --sd is no longer required when working inside a known storage directory.

Bug Fixes

• Nearby Sync reliability — Fixed state convergence issues where pending updates could be lost if a peer disconnected mid-sync. The sync manifest now includes stateId and projectId to ensure correct reconstruction on the receiving device.
• Nearby Sync self-discovery — The desktop app no longer accidentally discovers itself as a peer when background sync and Nearby Sync run at the same time.
• iOS App Intents — Removed ProvidesDialog from all App Intent implementations, which was causing Siri to display unexpected UI on iOS 17+.
• Security — Patched 26 dependency vulnerabilities flagged by Dependabot via pnpm overrides.

Bug Fixes

• Desktop renderer stability — Resolved a missing dependency that could cause the editor to fail to load in certain configurations.

New Features

• LaTeX math rendering — Inline $...$ and display $$...$$ math now render with KaTeX directly in your notes. Backspace on a rendered formula restores the source so you can edit it.

New Features

• PDF OCR — Imported PDFs are now scanned with OCR when they lack a text layer, making their contents searchable and indexable.
• Activity log — A dedicated activity log is now available, giving you a record of changes and sync events across your storage directories.

Improvements

• Faster startup — The app launches noticeably faster, particularly when opening with large storage directories.
• Task type pills — Task cards now show all assigned types rather than only the first one.

Bug Fixes

• iOS edits not appearing on desktop — Edits made on iOS were silently failing to replicate to the desktop. A five-part root cause chain has been resolved so changes now sync reliably in both directions.
• Search using semantic results unexpectedly — The main search bar was routing queries through semantic search in some cases. It now uses exact/keyword matching as expected; semantic search remains available separately.

New Features

• Pomodoro word count — The Pomodoro timer now tracks how many words you typed during each session.
• Semantic search auto-indexing — Notes are now automatically indexed for semantic search in the background when a storage directory is added, at startup, and when new content arrives from sync. No manual re-index needed.

Bug Fixes

• Settings advanced tab missing — The Advanced tab in Settings had disappeared; it is now restored.
• Smart folder deletions — Deleting a note or task from within a smart folder now immediately removes it from the list.
• Kanban board state updates — Task state changes on Kanban boards now reflect live without requiring a page reload.
• Pomodoro status bar — Disabling Pomodoro in Settings now correctly hides the timer in the status bar.
• Folder link navigation — Clicking a folder link while in a project or other secondary window now opens the main window with the correct folder selected.
• Semantic search errors — Fixed an error that occurred when performing a search with semantic search enabled.
• GitHub issue #2 — Fixed the reported crash/issue from the public issue tracker.

New Features

• Outline panel — A new outline panel shows a clickable table of contents derived from your note’s headings. Click any heading to jump directly to that section. Toggle it via the View menu, a toolbar button, or a keyboard shortcut.
• Advanced Search — A new Advanced Search dialog (Edit menu / ⌘⌥F) lets you filter notes by tags, folders, date ranges, and more, with the option to save any search as a Smart Folder.
• Similar items in backlinks — The backlinks panel now includes a “Similar Items” section showing semantically related notes, powered by local embeddings (opt-in; disabled by default).
• Comments stay open — The comment input no longer closes when it loses focus, making it easier to write longer comments without losing your work. Attempting to close the window while a comment is unsaved now prompts for confirmation.
• Task slug in backlink pane — Task chips in the backlink panel now show the full task slug, making it easier to identify tasks at a glance.
• Task slug in search results — Task cards returned in note-list search results now display the task slug.
• CLI: notecove recent — A new CLI command shows your most recently active notes, ranked by recency.
• CLI: semantic search — New notecove search related and notecove search similar commands find notes related to a given note or query using local embeddings.
• Kanban blocker filters — Kanban columns can now be configured with fine-grained blocker filters (blocked, blocking, or either), replacing the previous boolean “has blockers” toggle.

Bug Fixes

• Note content lost on load — A corrupted database snapshot could cause a note to appear empty when opened. The app now detects this condition and recovers the correct content from the append log automatically.
• Project reordering — Drag-and-drop reordering of projects and smart folders no longer snaps back to the original position after dropping.
• Smart filter editor crash — Opening the smart filter editor on certain filter configurations no longer crashes the app.
• Phantom untitled notes — Notes that existed only as empty CRDT metadata (no actual content) no longer appear as phantom “Untitled” entries in the notes list.
• Ghost note resurrection — Notes that had been deleted on another device no longer reappear after sync.
• Orphaned folder sync — Deleted folders are now correctly propagated during sync; folders deleted on one device are removed on others.
• Minimal window when task is deleted — Minimal task windows now close when their task is deleted, rather than remaining open showing stale content.
• History panel on project page — Task history is now visible on the project page, not just in the task detail sheet.
• Cloud sync warning “Learn more” link — The “Learn more” link in the cloud storage warning banner now points to the correct documentation page.
• Task deletion sync — Task deletions now propagate correctly even when the deletion timestamp predates the most recent sync guard.
• Notes list performance — The notes list is now virtualized; large libraries no longer cause slow note loads or sluggish switching between notes.
• CLI task deletion slowness — Deleting tasks via the CLI is significantly faster; deleted tasks no longer inflated slug prefix computation over time.

Security

• Electron security hardening — Enabled ASAR bundle integrity validation and tightened Electron fuse settings to reduce the app’s attack surface. The ASAR bundle is also significantly smaller, resulting in faster updates.

New Features

• Link to a folder — You can now create links that point directly to a folder, making it easy to reference locations in your notes and tasks.
• Cloud storage progress bar — A progress bar now appears when waiting more than a second for files to download from cloud storage.

Bug Fixes

• Breadcrumb links stay in the same window — Clicking a folder link in the breadcrumb now only changes the active folder in the current window, not other open windows.
• Backspace over link chips works correctly — Backspacing over an inline link chip in the editor now removes it cleanly.
• “Checking for updates” message no longer lingers — The update status message now dismisses promptly after the check completes.
• Blocked task indicator fixed — A task was incorrectly shown as blocked even when all its blockers were marked done; this is now resolved.

New Features

• Set task state at creation — Choose a task’s state when creating it, instead of always starting from the default.
• Folder links — Link to folders from notes using [[F: syntax, just like note and task links.
• Cmd-O quick open — Press Cmd-O to quickly search and jump to any note or task.
• Find inbound links (CLI) — notecove CLI can now find all notes and tasks that link to a given item.
• Emoji shortcuts — Type :), :D, :(, and similar sequences to insert emoji icons inline.
• Version in splash screen — The app version is now displayed on the startup splash screen.
• Better folder picker in project config — The folder selector in project settings now uses the same improved folder picker used elsewhere in the app.
• Smaller app bundle — Removed ~200 MB of unused cross-platform native binaries from the app, reducing download and install size.

Bug Fixes

• Cmd-N was throwing an error — Creating a new note with Cmd-N works again. It broke if you closed the original window.
• Markdown import preserves link text — Links with custom display text are no longer converted to chips on import.
• Manual note ordering was broken — Drag-to-reorder in note lists now saves and persists correctly.
• Comment box was eating newlines — Pressing Enter in the comment input now works as expected.
• Comment pane no longer auto-collapses — The comment pane only collapses when you explicitly close it with the X button.
• CLI note history no longer errors on success — notecove note history was incorrectly treating a 201 response as an error.
• Print preview renders chips — Task and folder chips now appear correctly in print preview.
• Help → Show Tip works again — The menu item was silently no-oping; it now shows a tip as expected.
• “Open with Markdown” targets the focused window — Previously opened the file in all windows; now opens only in the most recently focused one.
• Folder breadcrumbs are clickable — Click any segment of the folder breadcrumb to navigate directly to that folder.
• Down arrow on hashtag moves to next line — Pressing down after typing a hashtag (when autocomplete isn’t open) now correctly moves the cursor down.
• Cursor no longer vanishes near URL chips — The text cursor is now visible when positioned adjacent to a URL chip.
• CLI --diff-file handles task link replacements — Task link replacements were silently skipped when using --diff-file; they are now applied correctly.

Document & Task History

• Task history — Tasks now have a full revision history, just like notes. View, compare, and restore past versions.
• Word-level diff highlighting — History diffs now highlight the exact words that changed, not just the lines.
• Scroll-to-change and sub-batching — The history view scrolls to the first change in each revision and groups rapid edits into sensible batches.

Backlinks

• Backlinks panel — Notes and tasks show a panel listing everything that links to them, making it easy to navigate your connected content.

File Attachments

• Attach any file to a note — Notes now support arbitrary file attachments (PDFs, images, spreadsheets, etc.), not just inline media.

Cross-SD Move

• Move notes and tasks across sync directories — Notes and tasks can now be moved between different sync directories with full CRDT data migration, so sync history is preserved.

Accessibility

• WCAG 2.1 AA compliance — Comprehensive accessibility overhaul across desktop and iOS: VoiceOver support, High Contrast theme, keyboard-navigable UI, focus-visible indicators, ARIA roles and labels, reduced motion support, Dynamic Type on iOS, and automatic detection of OS accessibility preferences.
• Keyboard shortcuts panel — A new settings panel lists all keyboard shortcuts and is accessible from the Help menu.

Comments & Emoji

• Full emoji picker for reactions — Comment reactions now use a full emoji picker with search, and custom emoji render as chips in comment inputs and reaction bars.

CLI Enhancements

• notecove serve --with-auth — Zero-configuration remote SSH setup: generates credentials and configures the server in one command.
• Note/task version tagging and diff — Tag specific versions of a note or task and compare them with --diff in notecove note edit.
• task show --format markdown-with-comments — Fetch a task’s content and all comments in a single command.
• Better diff error reporting — When a patch fails to apply, the error now includes the relevant note context to make it easier to diagnose.
• Auto-uppercase project slug prefixes — Projects created via CLI now always produce uppercase slug prefixes (e.g. NOTE- not note-).

Bug Fixes

• Adaptive slug lengths — Each task’s slug prefix now uses the minimum number of characters needed to stay unique. Two slugs like NOTE-1234 and NOTE-1236 can coexist with a short slug like NOTE-abc — each gets exactly as many characters as it needs.
• Subtask buttons in task detail — Create or link a subtask directly from the task detail panel.
• Default folders protected — Project default folders can no longer be accidentally deleted.
• Sync could be blocked when an item was unconditionally preserved in a deleted state
• Note duplication produced empty content; cross-SD task body links were not rewritten after move
• Backlinks panel on tasks required double-clicking to open
• Find & Replace was skipping every other match when clicking Replace
• CLI install dialog PATH advisory was always shown, even when PATH was correct
• Cmd+Shift+B conflict between blockquote and Show Backlinks — now uses a non-conflicting shortcut
• Table column resize handles were not working reliably
• Link editor popover could appear outside the viewport
• Link toolbar used chip mode when text was selected — now inserts a display link
• Pasting a URL over selected text now inserts a link instead of chipping/unfurling
• Task editor toolbar now stays fixed as the description scrolls
• Cmd+N was passing a null folder ID instead of the current folder
• Kanban boards with state-based column configuration now honor that config
• “Check for Updates” returned a 404 error on nightly builds
• Reduced idle CPU usage — activity sync now skips unchanged files, log output is throttled
• App icon updated: rounder corners, better spacing, refined rudder

New Features

• No Node.js required — CLI now uses the Electron binary as its runtime; users no longer need Node installed separately when running locally (as opposed to using it remotely with notecove serve)
• What’s New dialog — shows release notes on first launch after upgrading
• Did You Know? tips — startup tip dialog surfaces lesser-known features
• Document history rework — new UX: scroll, compare, restore, diff, duplicate; media renders in preview
• Resolve comment threads — ability to resolve and reopen comment threads
• Timestamp shortcuts — @ts, @dt, @uts, @udt in the @ autocomplete menu
• CLI: note comments — create, resolve, and reopen comments from the CLI
• CLI: surgical diff apply — --content/--content-file uses minimal diff patching instead of full replace
• CLI: note show --format markdown-with-comments — combined content + comments in one fetch
• CLI: project descriptions, task list pagination — richer agent-facing output
• Auto-expand comment replies — comment reply threads expand by default
• Task assignee field — assigneeId added across all layers
• CLI: project archive/restore, batch task changes, stdin support (--content-file -) to reduce tool invocation needs

Bug Fixes

• Images showing “failed to load” in lightbox, print preview, and PDF viewer
• Hashtag autocomplete incorrectly appearing when opening task detail
• Cancelling profile picker now exits app instead of hanging
• Task detail opened via CLI now uses minimal window (matching double-click UX)
• iOS onboarding used “private to this iPad” wording on iPhone — now device-aware
• Kanban column config expand toggle uses correct icon
• Breadcrumbs missing in note windows opened via CLI
• New comment textbox sometimes not focused when opening thread
• Task link card popping up off-screen
• Task links with | breaking table cell rendering
• Code blocks missing visible border in light mode
• Profile picker “don’t ask again” and switch-profile bugs
• Folder drag-and-drop dropping in wrong position
• Cmd-F not focusing find bar when already open
• Presentation mode missing rendering for tables, checkboxes, links, headings, syntax highlighting
• CLI --install-cli --ssh now uses login shell for node detection

New Features

• Presentation Mode — Notes can now be displayed as presentations with speaker notes support, letting you run slideshows directly from NoteCove.
• MCP server — notecove mcp exposes NoteCove as a Model Context Protocol server over stdio or a TCP port, enabling AI tools to read and write your notes and tasks.
• Note links — Notes and tasks can now link to other notes using [[N:<id>|title]] syntax, creating navigable connections between documents.
• Task state at creation — When creating a task via the dialog or CLI, you can now set the initial state directly — no need to change it after creation.
• Move tasks between projects — notecove task change --move-to-project lets you reassign a task to a different project from the command line.
• notecove note edit via diff — CLI note editing now supports a diff-based workflow for making targeted changes to note content.
• --content-file for task create — notecove task create now accepts --content-file to read task body content from a file.
• notecove serve remote install — notecove serve now includes an option to install the CLI on the remote machine, making it easier to set up remote access.
• CLI JSON consistency — JSON output is now consistent across all CLI commands, making it easier to pipe notecove output into other tools.

Bug Fixes

• Task modified date — Tasks were always showing their creation date as the modified date; the modified timestamp now updates correctly on changes.
• Child task live updates — Tasks shown in a parent task’s child tree now live-update when changes occur, instead of requiring a manual refresh.
• Markdown rendering via CLI — notecove task change --content --content-format markdown now correctly renders the content as markdown in the app.
• CLI #tag propagation — Updating a task’s body with a #tag via the CLI now immediately updates kanban boards showing that task.
• task show --json state name — task show --json was returning null for state.name even when a state was set; it now returns the correct value.
• CLI slug disambiguation — Short slug prefix rejection was too aggressive, causing valid unique prefixes to be incorrectly rejected.
• URL linkification — URLs without an http:// or https:// prefix are no longer incorrectly converted to links.
• notecove note open type check — Passing a task ID to notecove note open now shows an error instead of displaying the task body as if it were a note.
• Find popup in task view — The cmd-F find popup now stays fixed at the top while task content scrolls beneath it.
• Note window breadcrumb — Note windows opened via notecove open now reliably show the breadcrumb bar.
• Trash empty display — After emptying the trash, the recently deleted folder now correctly shows as empty without requiring navigation away and back.
• Projects list reordering — The projects list can now be reordered by drag and drop.
• Website platform detection — The download page now correctly detects your platform and highlights the right download.

New Features

• DOCX export — Notes can now be exported as .docx files for use in Word, Pages, and other document editors.
• Folder search — A search field in the sidebar lets you filter the folder tree by name, making it faster to navigate large folder structures.
• Startup progress — A splash screen during startup shows granular loading progress as your storage directories are initialized, replacing the blank window while the app loads.
• CLI note comments — Note comments are now accessible and manageable via the command-line interface.

Bug Fixes

• Print preview — Notes now print in light mode regardless of your current app theme, so text is black on white paper.
• Dark/light mode switch — Switching between dark and light mode now immediately updates all open windows.
• Task description indicator — The asterisk (*) indicator showing that a task has a description now appears correctly on tasks with long titles.
• Kanban search — Searching in the kanban or list view no longer shows stale or duplicate task cards.
• Duplicate project slug — Creating a project with a slug prefix that already exists now shows a clear error message instead of failing silently.
• Editor scroll — Long notes are now fully scrollable — text that wraps near the bottom of the window is no longer cut off.
• Comment input — The comment input box now expands as you type (up to 6 lines), making it easier to write longer comments.
• Markdown import folder picker — The folder selection dialog in markdown import now shows the full nested folder tree instead of a flat storage directory dropdown.

Data Integrity

• Full-state snapshot guard — Added a guard preventing inadvertent full-state CRDT snapshots from being written to the activity log, which could cause data issues in edge cases.
• Folder tree corruption recovery — Added detection and automatic repair for folder tree corruption, with telemetry to help diagnose root causes.

New Features

• Drag-and-drop reordering — Projects and smart folders in the sidebar can now be reordered via drag-and-drop.
• Tags on cards — Tags are now displayed directly on note and task cards, so you can see them at a glance without opening the item.
• Task detail breadcrumb — The task detail panel now shows a breadcrumb with the storage directory and folder path for better navigation context.
• CRDT health check tool — New notecove-admin crdt-health CLI command for diagnosing data integrity issues.
• macOS notarization — The app is now notarized by Apple, so macOS Gatekeeper won’t block it on first launch.

Bug Fixes

• SD deletion cleanup — Removing a storage directory now properly cleans up its associated projects, smart folders, and CRDT documents.
• Folder navigation — Fixed an issue where clicking on a folder wouldn’t always load the folder contents.
• Table deletion — Tables in the editor are now easier to delete.
• Note links from tasks — Clicking a note link from a task body in a project window now correctly opens the note.
• Task detail in search — Clicking on a task in the kanban/list search results now properly opens the task detail.
• Task state colors — Task link chips now update their colors when you change a project state’s color.
• Tag rendering in code — A # character inside backtick-formatted links is no longer incorrectly rendered as a hashtag.
• Task type on move — Fixed an issue where moving a task to another project could allow selecting “None” as the task type.
• Dismiss button — Removed the unnecessary close button from task detail when viewing in a normal window.
• Scroll position — Fixed folder panel scroll position resetting when switching storage directories, performing folder operations, or expanding/collapsing folders.
• Breadcrumb in linked notes — Opening a note from a task detail link now properly shows the breadcrumb area.
• CLI note open — notecove note open now opens the correct note.

Data Integrity

• Write-ahead validation — Singleton CRDTs (projects, folders, smart folders) now validate updates before writing, preventing entry count regressions.
• CRDT invariant assertions — Runtime assertions verify that project counts remain consistent after load/reload operations.
• Origin filter exhaustiveness — Internal update origin matching now uses a typed union instead of strings, preventing missed cases.

New Features

• Dismissable task detail pane — Task detail can now be dismissed when viewing in the sidebar.
• Resizable sidebar sections — Sidebar sections (folders, projects, smart folders) can be independently resized and scrolled.
• Close project window on remote delete — When a project is deleted from another device, its open window automatically closes.
• Validate task type on project move — Moving a task to a different project now validates and maps the task type correctly.
• SD selector for smart folders — Smart folder creation now includes a storage directory selector.
• Add existing SD — You can now point to an existing storage directory folder instead of always creating a new nested one.
• Description indicator — Task cards now show an asterisk (*) when the task has a description.

Bug Fixes

• Editor shortcuts — Restored Cmd-E end-of-line behavior in the editor.
• Dark mode in task previews — Fixed task link preview popup using incorrect theme in dark mode.
• Keyboard shortcut conflict — Removed Cmd-Shift-N shortcut for new folder (conflicted with system shortcuts).
• SD path detection — Fixed detection of existing storage directory at combined parent+name path.
• Kanban column filters — Enforced column filters on explicitly-positioned kanban tasks.
• Project sync — Fixed task:created broadcast to include full task object for reactive UI updates.
• Markdown import — Fixed HTML tags appearing in the editor when importing markdown files.
• Project creation — Fixed project creation failures and cross-arch build issues.