Repository navigation
Releases
Melo 2.2.0
Diagrams and document navigation
- Mermaid code blocks now render as diagrams, with inline zoom and pan, source editing, and Copy image / Copy code actions.
- Images support inline zoom and pan, reset, and fullscreen viewing.
- A compact contents rail replaces the separate outline sidebar. Hover to browse headings, or press ⌘⌥O / Ctrl+Alt+O to navigate with the keyboard.
- The footer shows how many notes link to the current document. Click to see all references at the end of the note.
A more flexible Melo conversation
- Dock the conversation beside your document or pull it back into a floating window. Resize the panel to suit your workspace.
- Attached files take priority when you ask Melo to organize or edit them, and document context changes appear more predictably during ongoing conversations.
- Typing in the conversation composer no longer recreates its size observer on every keystroke.
Editing and clipping improvements
- Improved rich-text and image copying, preserved formatting when pasting within Melo, and added Copy as Markdown with ⇧⌘C / Ctrl+Shift+C.
- Open document links directly with ⌘-click / Ctrl-click, with matching cursor feedback.
- Fixed table cell alignment and improved paragraph splitting and undo with the updated editor engine.
- Simplified the web clipping palette, including save actions, capture status, folder selection, and website icons.
macOS builds use the same fixed self-signed certificate as 2.0.2 and later. Users on those versions can update from within Melo. Users on 2.0.1 or earlier must install manually once. Your notes and workspaces are preserved.
These builds are not notarized by Apple. macOS may require approval in System Settings → Privacy & Security on first launch.
Melo 2.1.3
More reliable AI connections
- API connection settings now show whether a key has been verified, with clear feedback beside a rejected key.
- New settings use Verify and save. Verification happens before saving, so an incorrect replacement key leaves your previous working configuration intact.
- Unchanged verified settings use Test connection, which checks the saved configuration without replacing credentials or interrupting the active connection.
- Model discovery and API connection checks now follow your system proxy settings.
- Fixed the connection setup screen briefly appearing before a working AI conversation when opening the window for the first time.
Update window improvements
- Refined release note spacing and action placement. Once downloading starts, the window focuses on background downloading or installing the update.
macOS builds use the same fixed self-signed certificate as 2.0.2 and later. Users on those versions can update from within Melo. Users on 2.0.1 or earlier must install manually once. Your notes and workspaces are preserved.
These builds are not notarized by Apple. macOS may require approval in System Settings → Privacy & Security on first launch.
Melo 2.1.2
Fix installed AI tool detection
- Fixed an issue in 2.1.1 that could show a download prompt even when Claude Code or Codex was already installed. Existing tools are now reused when they can start, without requiring an exact match to Melo's default download version.
- Fixed detection and sign-in checks for npm-installed tools when Melo is opened from Finder, where the Node executable may be missing from PATH.
- Existing tools and account settings are preserved. Connection errors are handled when connecting; newly downloaded files still receive integrity and version checks during installation.
macOS builds use the same fixed self-signed certificate as 2.0.2 and later. Users on those versions can update from within Melo. Users on 2.0.1 or earlier must install manually once. Your notes and workspaces are preserved.
These builds are not notarized by Apple. macOS may require approval in System Settings → Privacy & Security on first launch.
Melo 2.1.1
Smaller download, AI tools when you need them
- Claude Code and Codex are now downloaded when you first connect, instead of being included in every Melo installer. Compatible tools already installed on your computer can be reused.
- Follow download progress in the connection card, cancel and retry interrupted downloads, or close the conversation and let the download continue in the background.
- The first conversation now guides you through connecting an AI tool. Empty conversations offer starting points for reading documents, drafting, and organizing files.
Clearer updates
- The update window shows distinct states for checking, up-to-date, failed checks, downloading, and ready to restart.
- Read release notes while an update downloads, continue downloading in the background, and choose when to restart.
Editor and preview refinements
- Click below a document's content to continue writing in a blank paragraph at the end.
- Removed the duplicate file-type label from search previews.
- Web clip properties now use the same captured website icon as the article header.
macOS builds use the same fixed self-signed certificate as 2.0.2 and later. Users on those versions can update from within Melo. Users on 2.0.1 or earlier must install manually once. Your notes and workspaces are preserved.
These builds are not notarized by Apple. macOS may require approval in System Settings → Privacy & Security on first launch.
Melo 2.1.0
Meet Melo, your workspace assistant
- Ask questions about the document you are reading. Melo follows the active file as you switch tabs, and selected text can be sent directly from the editor.
- Keep a conversation open while you work, or close it to the floating fish. Its appearance shows when Melo is working, waiting for you, or has a new reply.
- Use Claude Code or Codex, with account connections or supported API services. API credentials are stored using this computer's secure storage.
Organize files through conversation
- Paste or drop attachments into chat to save them to Inbox, then ask Melo to read and organize them.
- Discuss destinations and filenames before applying changes. Managed changes have an undo action that checks for newer edits.
- Ask Melo to update Markdown tags or create and edit Smart Folders using the same metadata and rules as the rest of the app.
Tags and search
- See document tags above the text and edit them in place, with suggestions from existing workspace tags and automatic saving.
- Hover over a tag to remove it, use keyboard undo and redo, or click its name to find related notes.
- Continue a search in Ask Melo from the Command-K palette, with your question ready to review before sending.
Refinements
- Improved file-processing feedback and reduced interruptions during routine Agent work.
- Kept the floating assistant clear of fixed controls and preserved the conversation window position when asking about selected text.
- Fixed a focus race when switching documents that could send chat input into the editor.
macOS builds use the same fixed self-signed certificate as 2.0.2 and 2.0.3. Users on those versions can update from within Melo. Users on 2.0.1 or earlier must install manually once. Your notes and workspaces are preserved.
These builds are not notarized by Apple. macOS may require approval in System Settings → Privacy & Security on first launch.
Melo 2.0.3
Notes and files, in one workspace
- Added an onboarding page showing how Melo manages PDFs, Word documents, presentations, images, and videos alongside Markdown notes.
- Refined the page with layered document previews and updated English and Simplified Chinese copy.
Fixes
- The macOS application menu now uses the Melo name consistently.
- File context menus no longer repeat the selected filename at the top.
- Pressing Escape in a Smart Folder context menu closes the menu without affecting result navigation.
macOS builds use the same fixed self-signed certificate as 2.0.2. Users on 2.0.2 can update from within Melo. Users on 2.0.1 or earlier must install manually once. Your notes and workspaces are unaffected.
These builds are not notarized by Apple. macOS may require approval in System Settings → Privacy & Security on first launch.
Melo 2.0.2
A better update experience
- Read release notes, follow download progress, and install from one update window.
- Update later or ignore a version. Automatic checks won't keep prompting for the same release.
- Check 60 seconds after launch, then every 24 hours. Automatic checks can be turned off in Preferences.
- Downloads are verified before installation. If a download fails, an earlier usable update is kept.
macOS builds now use a consistent self-signed certificate. If you're on 2.0.1 or earlier, install this version manually once. Future releases signed with the same certificate can be downloaded and installed by restarting Melo. Your notes and workspaces are unaffected.
These builds are not notarized by Apple. macOS may still require approval in System Settings → Privacy & Security on first launch.
Melo 2.0.1
Melo 2.0.1 improves first-run setup and file management in Smart Folders.
Download and installation
- Apple silicon:
melo-lite-2.0.1-arm64.dmg - Intel Mac:
melo-lite-2.0.1-x64.dmg
These macOS builds are unsigned and not notarized. macOS may require approval in System Settings → Privacy & Security after your first attempt to open Melo.
To update, quit Melo, open the DMG for your Mac, drag Melo into Applications, and choose Replace. Your workspace files are not part of the app bundle. Melo can check for later versions, but updates must be downloaded and installed manually from GitHub Releases.
Improvements
- Redesigned the first-run introduction with English and Simplified Chinese language selection and feature demonstrations.
- Added English and Chinese user guides covering editing, clipping, links, file management, search, export, and backups. Existing guide files are kept unchanged.
- Added rename, move, and Move to Trash actions to Smart Folder result menus.
Fixes
- Fixed outline controls when browsing and editing notes from Smart Folders.
- Removed redundant Open actions from workspace and Smart Folder menus.
- Isolated development app data from installed Melo builds.
See the full changelog for details.
Melo 2.0.0
Melo 2.0.0 rebuilds the editor around local workspaces while preserving single-file Markdown editing.
Download and installation
- Apple silicon:
melo-lite-2.0.0-arm64.dmg - Intel Mac:
melo-lite-2.0.0-x64.dmg
These macOS builds are unsigned and not notarized. macOS may require you to allow Melo in System Settings → Privacy & Security after your first attempt to open it.
Install 2.0.0 manually even if you are upgrading from 1.0.0: quit Melo, open the DMG for your Mac, drag Melo into Applications, and choose Replace when prompted. Your workspace files are not part of the app bundle. Melo 2.0.0 can check for later versions, but it will open GitHub Releases for manual installation rather than installing updates in-app.
Highlights
- Added first-run workspace setup, Inbox, a welcome guide, workspace switching, and session restore.
- Added fast full-text search, smart folders, wikilinks, backlinks, and unlinked mentions.
- Added web clipping with local images, PDF viewing, media previews, and Markdown, standalone HTML, and PDF export.
- Upgraded to Tiptap 3 with richer tables, task lists, math, code blocks, slash commands, block drag controls, Markdown-aware paste, find and replace, and multi-tab editing.
- Improved autosave, external-change reconciliation, file watching, incremental SQLite indexing, and English and Simplified Chinese interfaces.
See the full changelog for details.