SugiliteDownload
changelog

Release notes

Every shipped version of Sugilite, in order. Versions ship whenever something worth shipping is ready, not on a cadence.

← back to home

  1. v0.0.46

    2026-07-23

    AI clients can now attach images straight into a note, and subpath image links like ![](assets/x.jpg) render correctly.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    added

    • MCP attach_file — an AI client can attach an image by passing just the target note; the file is saved into that note's folder (auto-renamed on collision, same as the app) and a ready-to-paste ![[name]] embed is returned, so it no longer has to hunt for the vault or folder. Attachments to locked notes are refused, and over HTTP only inline content is accepted (never a local file path)

    fixed

    • Subpath image links like ![](assets/x.jpg) were resolved only from the vault root, so an image in an assets folder next to the note showed as broken (the cover thumbnail resolved by filename and looked fine, which was confusing). Links now resolve by matching an existing file, then relative to the note's own folder (Obsidian's default), then the vault root

  2. v0.0.45

    2026-07-04

    You can now run the built-in MCP server over HTTP so other devices on your network can reach it — no app window needed. Plus a fix for folder- and tag-scoped search that was silently dropping results.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    added

    • MCP over HTTP (LAN) — a new Settings › MCP section runs the server as a headless service other devices can reach at http://<your-ip>/mcp. It gives you a Bearer access token to show, copy, or regenerate (old token invalidated instantly), your connection URL with a client-config example, a copy-ready launch command, and a live running indicator. On macOS, a toggle auto-starts it at login and restarts it if it exits. The stdio mode is unchanged

    fixed

    • Folder- and tag-scoped search could silently drop results — a scope was applied only after taking the global top matches, so a note inside the folder that didn't rank globally was missed (semantic search within a folder effectively didn't work). Scopes are now applied before ranking, in both the MCP server and in-app search, so in-scope notes reliably surface

  3. v0.0.44

    2026-07-02

    In Reading View, table-of-contents links now jump to the right heading.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    fixed

    • In Reading View, a `[text](#heading)` anchor link (like a table of contents) did nothing when clicked; these now scroll smoothly to the matching heading using GitHub/Obsidian-style slug rules, tolerating hyphen-dialect differences and falling back to a block reference (^id) when no heading matches

  4. v0.0.43

    2026-07-02

    A big speed and reliability pass: the built-in MCP server gains safer, more capable tools for AI clients, the editor and indexer are noticeably faster on large vaults, and a long list of editing and preview bugs are fixed.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    added

    • MCP editing tools for AI clients — exact-match replace (edit_note) and append-to-end (append_note), so an AI can make a small edit without resending the whole note or risking clobbering its body; locked notes are refused
    • MCP discovery tools — backlinks plus outgoing links (note_links), your tag vocabulary with counts (list_tags), and title/[[wikilink]] → path resolution (resolve_note). read_note can now return a single section by heading with metadata and length-capped output, and new notes can be created with tags

    improved

    • Much faster on large vaults — auto-save no longer fires a heavy refetch fan-out or recomputes the whole link graph on every save, the editor stops re-scanning every line on each cursor move and redraw, embedding and full-scan work is trimmed, image-paste and PDF-export byte transfers use base64 IPC, and the Timeline is now virtualized

    fixed

    • An edit made while a save was in flight could be dropped from auto-save and lost, and an external-change reload could overwrite unsaved edits; both races are fixed
    • Bold text touching Japanese punctuation stayed exposed as `**` in preview, and Live Preview decorations could fire inside code blocks and inline code
    • Clicking a task checkbox in preview could rewrite a different line
    • Toggling a note's star or changing its title remounted the editor, and the folder tree collapsed on every auto-save
    • Renaming a note in the GUI left search showing the old title; word count only tallied the first 4 KiB of a note; and frontmatter wasn't recognized in files with CRLF line endings
    • Clicking frontmatter could throw a RangeError, and an image widget didn't reflect path changes

  5. v0.0.42

    2026-06-27

    Version history reaches the MCP server, so your AI can browse, diff, and restore past versions too. Folder deletion now goes to the trash, and a line-number spacing glitch is fixed.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    added

    • MCP version history — an AI client can list a note's versions, fetch any version's full text, get a git-style diff (version→version or version→current), and restore a version non-destructively. AI edits are recorded too; locked notes are refused and a version is always scoped to its own note

    improved

    • Deleting a folder now moves its notes to the trash (recoverable one by one) instead of permanently erasing them — matching single-note deletion. The confirm dialog now says “move to trash” to match

    fixed

    • With line numbers on, row spacing could jitter when editing blank lines; line height is now constant so the line numbers stay evenly spaced

  6. v0.0.41

    2026-06-27

    Notes now keep a version history you can browse and restore — plus editor fixes for the dark-mode gutter and folding with line numbers on.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    added

    • Note version history — each save snapshots the previous text, kept per note (up to 50 recent versions, auto-pruned after 30 days). Open it from a note's “…” menu for a dated list, a word-level diff (git-style: additions in green, deletions in red), and non-destructive restore of any version

    fixed

    • Dark mode: the line-number gutter no longer shows a grey background — it now matches the editor surface, and the active-line gutter highlight is off in both modes
    • With line numbers on, the fold chevron was hidden behind the gutter and couldn't be clicked; it now sits to the right of the gutter where it's reachable

  8. v0.0.39

    2026-06-10

    Large vaults show every note now — the 500-note list cap is gone — and saving stays fast no matter how many notes you have.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    improved

    • Card and list views render in windows of 120 as you scroll, so even an all-notes view stays light on first paint
    • Saving a note now fetches only the one note it touched instead of loading up to a thousand — quicker saves in big vaults

    fixed

    • Note lists (and the starred count) silently stopped at 500 notes; the cap is removed, so all notes show

  9. v0.0.38

    2026-06-09

    The updater no longer closes the app on Windows before you click Restart.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    fixed

    • On Windows, installing an update could close the app before the "Restart" button appeared. The updater now downloads the update first and only installs and relaunches when you click Restart (macOS behavior is unchanged)

  10. v0.0.37

    2026-06-09

    Markdown rendering now matches Obsidian much more closely — Mermaid diagrams, footnotes, highlights, comments, and collapsible sections.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    added

    • Mermaid diagrams render in reading view (loaded lazily)
    • Footnotes ([^1]) render in reading view
    • ==highlight== and %%comment%% are supported in both edit and reading views
    • Collapsible headings and lists — hover for a chevron to fold sections, in both views

    improved

    • Closer Obsidian-style rendering: restored bullet/number markers, better heading spacing, and custom checkbox states

  11. v0.0.36

    2026-06-09

    Sugilite now remembers your window size and position between launches.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    fixed

    • The window reset to its default size on every launch. It now saves your size, position, and maximized state when you close it and restores them on the next start (the default still applies to a brand-new install)

  12. v0.0.35

    2026-06-09

    The new-note dialog now puts the title front and center.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    improved

    • Redesigned the new-note dialog: the title is now a large, underline-only hero input, while template selection drops to a small footer dropdown (hidden entirely when you have no templates) — so the title clearly leads instead of competing with the template picker

  13. v0.0.34

    2026-06-08

    Sugilite now speaks six languages and picks yours automatically, and AI clients can manage folders over MCP.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    added

    • Four new interface languages — Simplified Chinese, Korean, German, and Spanish — joining English and Japanese, selectable in Settings
    • MCP gains delete_folder and rename_folder, so an AI client can manage folders too, not just notes

    improved

    • The interface language is now chosen from your OS locale on first run (ja / zh / ko / de / es map to that language, everything else to English)

  14. v0.0.33

    2026-06-07

    The vector map is now a living, force-directed layout where closeness really means relatedness — and it handles like the graph view.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    improved

    • Vector map redesigned as a force-directed layout: semantic nearest-neighbours act as springs that pull related notes together while clusters repel each other, so distance on screen reflects how related notes actually are (instead of a fixed UMAP/PCA projection)
    • It now shares the graph view's controls — drag, pan, zoom, and hover to highlight a note's neighbours; labels avoid overlapping and expand to full titles on hover. Colour marks the semantic cluster, lines mark nearest neighbours

  15. v0.0.32

    2026-06-07

    A performance and robustness pass: faster startup and search, plus hardening so heavy use and background AI access stay stable.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    improved

    • Faster startup — the vault opens immediately and reconciles in the background instead of blocking on a full scan
    • Faster search — the semantic index is warmed off the search path and hybrid search loads only the candidate notes instead of every vector
    • More robust under heavy and concurrent use — a database busy-timeout, single-instance launch, and poison-resistant embedding so a failed write can't wedge the search index (including when an AI client is using the MCP server)

    fixed

    • Renaming a note now re-embeds it so semantic search and related notes stay accurate, and a status edge case that could violate a database constraint is resolved

  16. v0.0.31

    2026-06-06

    A smoother launch — no more onboarding flash when you already have a vault — plus crash logging for better diagnostics.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    improved

    • Crashes are now logged: a panic handler writes the message, location, and backtrace to a panic.log, so an issue can be diagnosed even on stripped release builds

    fixed

    • On launch, the onboarding screen could briefly flash before your existing vault opened. Startup now shows a neutral loading splash and only ever draws onboarding when there's genuinely no vault to open

  17. v0.0.30

    2026-06-06

    Sharper semantic search, a unified search-and-filter, and a fix for the vector map hanging on small vaults.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    added

    • Drag a note card or list row onto the tab bar to open it in a new tab

    improved

    • More accurate semantic search — note titles are now folded into each note's embedding (+6.7pt Recall@5 on real data) while keyword search stays unaffected; edits and renames re-embed automatically
    • Search and filtering are now one thing: search_notes pulls out folder: / tag: / path: as scopes, runs hybrid (keyword + semantic) search on the rest, then narrows to the scope — or just lists when you give only an operator
    • Stale embeddings are swept up — a startup + on-edit garbage collector clears leftover vectors from past edits and keeps the search index to live content only

    fixed

    • Vector map could hang on small or near-identical vaults (the UMAP projection failed to converge); it now falls back to a PCA layout in those cases

  18. v0.0.29

    2026-06-05

    The vector map now colours notes by meaning, not by folder, so semantic clusters are obvious at a glance. The ⌘K search palette also remembers your last query.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    improved

    • Vector map points are now coloured by semantic cluster (k-means over the embeddings) instead of by folder name — notes about similar things share a colour, so meaning groups are visible at a glance. Clustering is deterministic, so colours don't flicker between redraws
    • The ⌘K search palette keeps your last query and results instead of clearing on open; it focuses and selects the text so you can press Enter to reuse it or just type to replace

  19. v0.0.28

    2026-06-03

    A note title with a slash no longer silently creates stray folders. Forbidden filename characters are now handled consistently everywhere a note is made.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    fixed

    • A "/" (or other path character) in a note title was read as a folder separator, creating unintended subfolders — e.g. a title like "C++/ggml notes" split into a "C++" folder. New-note, import, and MCP creation now share one path resolver: it only follows folders that already exist and strips forbidden characters (< > : " / \ | ? * and control chars) from the filename
    • Inline title editing now rejects forbidden characters when typed (with an error, like Obsidian) and quietly removes them on paste

  20. v0.0.27

    2026-06-02

    New notes now always open in edit mode, ready for you to start typing.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    fixed

    • A freshly created note opened in read mode if that was your last-used editor mode. New notes (from the new-note dialog, ⌘N, a template, or creating a note from a wikilink) now always open in edit mode — your default mode for existing notes is left untouched

  21. v0.0.26

    2026-05-30

    The MCP server now lists empty folders too, so an AI client can create notes in folders you've set up but not yet filled.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    fixed

    • MCP list_folders now includes empty folders (zero notes) by scanning the vault directly instead of inferring folders from existing notes — so an AI client can place a note in a folder you prepared but left empty (hidden and locked folders stay excluded)

  22. v0.0.25

    2026-05-30

    Open notes your way. Note cards, list rows, and the Inspector's related notes and backlinks all gain a right-click menu for opening a note in a new tab, in Finder, or in your default app.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    added

    • Right-click a note card or list row to open it in a new tab, reveal it in Finder, or open it in your default app
    • Related notes and backlinks in the Inspector get a full right-click menu too — open (new tab / Finder / default app), lock, rename or delete, without leaving the panel

  23. v0.0.24

    2026-05-29

    Onboarding is now a guided step wizard, and first-run users get a one-time card that walks them through connecting Sugilite to their AI client over MCP. New vaults ship a Welcome note with client-agnostic MCP setup instructions.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    added

    • Step-by-step onboarding — a card-style vault picker (open an existing folder or create a new one) with icons, descriptions and step dots, fronted by the Sugilite mark
    • First-run MCP intro card, shown once per device after a vault opens: a copy-paste MCP config snippet framed by the real client logos — Claude, ChatGPT, Cursor, Gemini
    • New vaults now include a Welcome note with a neutral, client-agnostic MCP setup section (examples for Claude Desktop / Cursor), localized in English and Japanese

  24. v0.0.23

    2026-05-28

    MCP tools now return a uniform note shape across the board, search_notes gains a long list of filters and sort options, and Mac users with external image drops no longer hit 404s.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    added

    • MCP search_notes filters: path_prefix, updated_since / updated_until, created_since / created_until, min_words / max_words, min_links, starred_only
    • MCP search_notes sort: relevance (default with query) / updated_desc (default without) / updated_asc / created_desc / created_asc / title / words_desc
    • MCP list_notes args: sort, updated_since, created_since, limit; response now carries excerpt, tags, dates, word_count, backlink_count, starred
    • Source-view (</>) icon restored on plain Markdown images (![](path)), so bookmark / import flows can inspect and edit the path

    improved

    • Unified MCP note object across list_notes / search_notes / related_notes / read_note: path, title, excerpt, tags, created_at, updated_at, word_count, backlink_count, starred (with snippet on search, similarity on related)

    fixed

    • Mac: in-note images added to the vault from outside the app (e.g. via the MCP server while the GUI was running) resolved to vault root and 404'd; basename misses now fall back to the current note's folder, and the image cache refreshes on vault://changed events

  25. v0.0.22

    2026-05-27

    Related notes lands in the Inspector and the MCP server. The search palette now suggests DSL operators when the input is empty so you can drop into a typed query without remembering the syntax. (v0.0.21 was not shipped as a build — its work is bundled into this release.)

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    added

    • Related notes panel in the Inspector — semantically nearest notes via cosine similarity on note-centroid embeddings, up to 5 entries, auto-refreshing after writes and renames
    • MCP: new `related_notes(path, limit?)` tool, plus an optional `include_related` / `related_limit` on `read_note` to fetch body + neighbours in one call
    • Search palette operator suggestions — when the input is empty, ⌘K shows the full DSL palette (tag: / folder: / path: / title: / created> / updated< / words> / links< / sort: / limit:); arrow + enter inserts so you can start typing the value
    • Bilingual (English / Japanese) strings for both features

  26. v0.0.20

    2026-05-26first public release

    The first build of Sugilite that's ready for the wider world. Everything below ships in this drop.

    Download for macOS.dmg · Apple SiliconDownload for Windows.exe · x64

    added

    • Local-first markdown editor with wikilinks and backlinks
    • Hybrid search blending keyword and on-device semantic retrieval
    • DSL query language (tag: / folder: / created> / updated< / sort:)
    • Standalone Model Context Protocol server — runs without the GUI, exposes search / read / write / graph / embed as tools to Claude, Cursor, Zed, and any MCP-compatible client
    • Force-directed knowledge graph and 2D UMAP vector map of note embeddings
    • Calendar and timeline views over your daily notes
    • Obsidian vault compatibility: frontmatter properties, [[wikilinks]], ![[embeds]], YYYY-MM-DD daily-note detection, templates folder, CSS themes
    • macOS (Apple Silicon) and Windows (x64) builds