Release Notes

Highlights

Dark mode, video support, variables, color picker & swatches, plus improvements to tables and HTML.

What's New

• Dark mode — switch between light, dark, or system theme in Settings.
• Multiple windows — open more than one Moss window at once when you want separate notes or workspaces side by side.
• Video support — embed local videos or YouTube videos in any note. Play them inline, or open a fullscreen video player. Insert with /media, by dragging in a file, or by pasting a YouTube link.
• Variables — define variables once, such as medium=500, then reference them from formulas and other variables so related numbers update together, such as large=medium*2. Variables and formula references render as value-only inline pills with hover cards for definitions.
• Color picker & color swatches — type /color to open a color picker and insert editable color swatches. Typing a HEX, RGBA, or HSLA code in the editor also opens the picker.
• Moss Skills on GitHub — the same skills the Moss agent uses to work with notes are now available publicly as agent skills and as Claude Code and Codex plugins, so you can use Moss with any agent: github.com/brsbl/moss-skills
• Agent token counts — hover over an agent run in the right panel to see its total token usage.
• Refreshed typography — a cleaner type system and hierarchy.

Improvements & Fixes

• Selection toolbar — selecting text now positions the formatting toolbar above the selection for more comfortable editing.
• Sync & stability — externally edited files refresh automatically, files added outside Moss appear instantly in the sidebar, and media-heavy workspaces are less likely to overwhelm file watching.
• Embedded HTML — run HTML inside Moss notes. Moss shows a rendered preview in the editor that you can now activate and use interactively inline, or expand into a fullscreen interactive experience. Useful for prototypes, dashboards, component previews, or more.
• PDF export — saving a note as a PDF is much more reliable and now shows a preview before you save.
• Tables — table columns can be resized, and table cells can hold all interactive note content such as media and HTML.
• Navigation & search — use keyboard navigation to move between note search results when using ⌘F.
• Anchor links — select a heading and use the copy note link button to copy a link directly to that heading.
• Code blocks — newly inserted code blocks now focus the code editor so you can immediately start typing.
• Sidebar menus — folder and note menus now stay above sidebar content instead of being partially covered.

Website & Docs

• Refreshed documentation for setup, import, sync and backup, Git, and Claude Code troubleshooting.
• Refreshed in-app onboarding with clearer Getting Started and Use Cases notes.

Highlights

Split view polish, smoother scrolling & bug fixes.

Improvements

• Folder sorting — notes inside folders now respect your chosen sort order
• Mention search — typing @ now drills into connected folders
• Collapsible headings — the toggle no longer overlaps text, making it easier to select heading ranges
• Actions panel — remembers which tab you were on when switching notes
• Trash — right-click trashed notes to open them read-only or reveal in Finder
• Copy Link — quickly copy a wiki-link to any note from the sidebar menu
• Comment sidecars — comment metadata is now stored in a separate comments.json file alongside the note

Bug Fixes

• Fixed split view showing duplicate lightbox overlays and truncated breadcrumbs
• Fixed the agent not flushing the right pane before writing in split view
• Fixed scroll jumping during drag-select near the bottom of a note
• Fixed gap cursor clicks landing on the tab bar instead of between blocks
• Fixed lightbox appearing behind the editor overlay on the wrong pane
• Fixed breadcrumbs overflowing for notes with long paths in connected folders
• Fixed large pasted tables freezing the editor
• Fixed the canvas header not responding to drag on the top edge
• Fixed external links blocking the UI thread when opened from a note

Highlights

Split view, tabs, mockup previews, and a new properties panel.

What's New

• Split view — open two notes side by side; right-click any note or wiki-link and choose "Open in Split Tab"
• Tabs — organize content into tabbed sections within a note using /tabs
• Workspace settings — choose where Moss stores your notes from Settings → Workspace Location
• Mockup preview — click a mockup image to interact with the live HTML in a full-size lightbox
• Folder drag-and-drop — drag folders in the sidebar to rearrange and nest them

Improvements

• Smarter property suggestions — properties are now suggested dynamically based on your workspace content instead of from a fixed list
• Agent activity indicator — the actions tab opens automatically when the agent starts, with a pulsing dot so you know it's working
• Redesigned properties panel — cleaner layout with form fields, delete confirmation, and reordered properties
• Collapsible sidebar sections — pinned and folder sections show a caret when collapsed

Bug Fixes

• Fixed the file watcher crashing on macOS 15+ when watching many files
• Fixed the toolbar requiring multiple clicks to activate
• Fixed tab content lost when removing all but one tab
• Fixed the actions button click being swallowed by the canvas
• Fixed various lightbox sizing and positioning issues
• Fixed external folders still appearing expanded after relaunch

Highlights

Pin notes to the top of the sidebar, add text to sketches, a polished UI & more.

What's New

• Pinned notes — pin any note to keep it at the top of the sidebar
• Sketch labels — add text labels to your sketches to annotate diagrams and drawings
• Redesigned floating toolbar — cleaner visual hierarchy, only visible when the editor is focused, with a button to open the Moss agent directly from the toolbar

Improvements

• UI refresh — improved hierarchy and organization across all panels, menus, and the canvas for a cleaner visual flow
• Refreshed sidebar — unified scroll with sticky section headers, sort direction indicators, and tighter spacing
• Smarter agent — picks better models for different tasks and responds with more focused instructions
• Folder actions — right-click a folder for all actions in one dropdown, with confirmation before deleting
• Simplified highlights — highlighting is now a single yellow toggle (⌘⇧H) instead of a color picker
• Auto Properties and Suggested Links off by default — Note Intelligence is now opt-in from Settings to keep things lightweight
• Simplified link insertion — the ⌘⇧K shortcut was removed; paste a URL over selected text to create a hyperlink

Bug Fixes

• Fixed bold and italic formatting sometimes lost when reopening a note
• Fixed bold breaking in text with special space characters
• Fixed raw ** characters appearing instead of bold formatting
• Fixed nested list structure lost when reopening a note
• Fixed clicking a search result not scrolling to the match
• Fixed duplicate notes appearing when external files were saved rapidly
• Fixed agent sometimes writing the note title twice in the body
• Fixed external folders picking up developer files like node_modules

Highlights

Callout blocks, new chart styles, code block themes, and a refreshed toolbar — plus smoother note switching and more reliable comments.

What's New

• Callout blocks — add warning, info, and priority callouts to your notes
• Chart palettes — new color palettes for charts, plus stacked-bar and multi-series charts
• Code block themes — syntax highlighting with line numbers
• Image attachments — attach images in the agent prompt and comment threads with the paperclip button

Improvements

• Refreshed toolbar — reorganized formatting options, word count in the status bar, and a keyboard shortcuts tray
• Smoother note switching — notes appear instantly when you navigate, no loading flash
• More reliable comments — overhauled the comment system so comments stay put across edits
• Easier sharing — simpler flow to share and invite the agent to your notes
• Image drop targeting — drag an image into your note and a guide line shows where it will land
• Drop multiple images — drag several images at once and they all insert in order
• Custom properties — add and edit your own properties alongside the ones Moss creates automatically

Bug Fixes

• Fixed bold formatting breaking when applied over inline code
• Fixed toolbar indent/outdent button behavior
• Fixed date picker dialog not centering on screen
• Fixed arrow key navigation around images, charts, and sketches

Highlights

Redesigned header and panels, more easily share notes with any AI agent, and performance improvements.

What's New

• Share with Agent — copy your note's path and editing instructions to paste into any external AI agent
• Image lightbox — click any image to view it full-size; hover for an expand button
• Note Intelligence toggle — turn Auto Properties and Suggested Links on or off from Settings

Improvements

• Redesigned header — docked at the top instead of floating over the editor; overflow menu replaces individual action buttons; panel expand buttons appear when panels are hidden
• Redesigned sidebar — icon rail removed; settings, trash, and feedback now in a compact footer with a collapse button
• Title is now contenteditable — "Untitled" shows as placeholder text, feels more like writing
• Rotating placeholder text — new notes show playful rotating prompts like "What if..." and "Keep pulling that thread..."
• Faster toolbar — no longer slows down typing on long notes
• Pill navigation — use arrow keys to move between tags and people in properties
• New shortcuts — ⌘E inline code, ⌘L bullet list, ⌘⇧L numbered list, ⌘⇧K insert link, ⌘⇧\ toggle sidebar
• Richer copy/paste — code blocks, charts, and formulas paste as their original markdown
• Auto em dash — typing -- converts to an em dash as you write
• Renamed for clarity — "Inferred Metadata" is now "Auto Properties," "Linked Folders" is now "Connected Folders"
• Visual polish — lighter property card, simplified search bar, subtler scroll fade, tighter settings

Bug Fixes

• Fixed inline code format sticking after deleting all code characters
• Fixed formatting whitespace leaking into bold/italic spans
• Fixed checkbox toolbar button not toggling off existing checklists
• Fixed collapsible heading chevrons drifting during scroll
• Fixed pill deletion removing all duplicates instead of the targeted pill

Highlights

Improved agent reliability in the desktop app.

Bug Fixes

• Fixed the agent failing to start in certain environments

Highlights

Fixed the agent failing to run in the desktop app.

Bug Fixes

• Fixed the agent failing to run in the desktop app

Highlights

Fixed false sign-in warning blocking the agent prompt.

Bug Fixes

• Fixed false "sign in" warning blocking the agent prompt

Highlights

No more sign-in inside Moss — if Claude Code is set up on your machine, the agent just works. Plus smoother context menus and better error messages.

Improvements

• Simpler authentication — Moss no longer has its own sign-in flow. If you have Claude Code set up, the agent is ready to go
• Open folders in Finder — right-click any folder to reveal it in Finder
• Cleaner context menus — consistent ordering across notes and folders, with destructive actions safely at the bottom
• Better error messages — when something goes wrong with the agent, you'll see a clear explanation instead of a wall of text

Bug Fixes

• Fixed the agent sometimes failing to start in the packaged app
• Fixed notes created outside Moss not always appearing in the sidebar
• Fixed paste occasionally overwriting content near images or code blocks

Highlights

Improved clipboard handling so paste works reliably with all content types, plus better detection of notes added to your workspace from outside Moss.

Bug Fixes

• More reliable paste — copying and pasting near images, formulas, charts, or code blocks now works as expected
• External notes sync automatically — notes added to your workspace outside Moss (e.g. via Finder) are picked up without restarting
• Improved sign-in diagnostics — better logging when connection issues occur

Highlights

Bug fixes and stability improvements.

Bug Fixes

• Fixed agent execution failing with "OAuth authentication is currently not supported" after sign-in
• Fixed stale cached tokens blocking the sign-in flow
• Improved recovery when credentials are revoked mid-session

Highlights

Organize notes into nested folders, browse them right from @-mentions, and hide finished to-dos under collapsed headings. Plus faster image loading and smoother editing.

What's New

• Nested folders — create subfolders inside existing folders for deeper organization
• Browse folders in @-mentions — press Tab to drill into a folder when mentioning notes; Shift+Tab to go back up
• Export as Markdown — save a clean copy of any note as a standard .md file, with Moss-specific syntax stripped out
• Resolve all comments — one-click button in the command palette to ask the agent to address every open comment

Improvements

• Collapse headings remember their state — collapsed sections stay collapsed when you reopen a note
• Hide finished to-dos — headings with checklists can now hide just the completed items, keeping your remaining tasks front and center
• Improved performance with large files — images load as you scroll instead of all at once, and pasting long documents no longer freezes the editor
• Simplified copy actions — cleaner options for copying note paths and content
• Sidebar polish — folders and notes are easier to scan, with subtle scroll indicators
• Frontmatter editing — single-click to edit metadata fields; better keyboard navigation inside them
• Sign-in reliability — improved credential handling for a smoother experience
• Comment shortcuts — use Cmd+Enter to submit comments

Bug Fixes

• Fixed checklist sorting scrambling nested sub-items
• Fixed a crash when note titles were very long
• Fixed Tab key incorrectly indenting paragraphs and headings
• Fixed comment indicators appearing next to collapsed headings
• Improved comment popover stability

Highlights

A stability and performance update. The app launches faster, formulas are more reliable, and the underlying engine has been upgraded.

Improvements

• Faster startup — background tasks like file watching now start after the window is ready, so the app opens quicker
• Updated engine — upgraded to Electron 40 for better performance and security

Bug Fixes

• The agent prompt now guides you to sign in when you're not logged in
• Fixed crash reporting so fatal errors are captured correctly
• Improved error handling during note inference

Highlights

Moss now suggests related notes as you work, and metadata fields are clickable — tap a tag, person, or type to find every note that matches. The agent can organize your notes into folders, and PDF exports look sharper.

What's New

• Suggested links — Moss surfaces related notes below your links panel, with a reason for each suggestion (shared topic, same folder, or metadata match)
• Clickable metadata — click any type, status, person, or date in the property card to run a fielded search across your workspace
• Folder organization — ask the agent to organize your notes into folders
• Feedback dialog — submit feedback directly from the app

Improvements

• PDF export quality — tables, code blocks, and images render with better fidelity
• Image auto-copy — dropping or pasting a local image copies it into the note's assets folder automatically
• Window drag — programmatic drag for transparent windows works reliably on all macOS versions

Bug Fixes

• Fixed PDF parser entering an infinite loop on certain documents
• Fixed multiline blockquotes losing content on import
• Fixed fenced code blocks losing language labels after round-trip
• Fixed title sync writing stale values during fast edits
• Fixed agent skeleton layout shifting during action loading
• Reduced noisy log output and throttled repeated warnings

Highlights

Bug fixes and polish across sign-in, the editor, and sidebar navigation.

Improvements

• Sign-in and disconnect are more reliable
• Cursor stays in place during fast typing in the prompt
• Bold and italic preserved inside other text styles on import
• Comments display and align correctly after editing and resizing
• Folders stay visible while scrolling through notes

Highlights

Stability updates for first-run and app update reliability. This entry combines patch notes from versions 0.5.4 through 0.5.7.

Bug Fixes

• Fixed first-launch cases where the app window could remain invisible
• Fixed dock activation so a hidden window is restored correctly
• Fixed startup blocking on analytics initialization during first run
• Fixed update-card state handling that could hide the "Restart to update" action
• Fixed launch-time changelog fallback behavior that could show the wrong version
• Fixed update-card action layout/readability when both actions are visible

Highlights

The agent now cites its sources when using web search, and formulas are easier to work with. Press Enter to finish editing instead of clicking away.

Improvements

• Agent cites sources when using web search
• Press Enter to finish a formula instead of only Space or clicking away
• Comment colors persist across sessions
• Onboarding skills auto-adopt on first run

Bug Fixes

• Fixed comment input dismissing immediately after opening
• Agent messages now stay visible after the agent finishes
• Comments now preserved correctly after undo
• Skill notes now appear in the correct folder on first run
• Fixed Edit button showing on comments written by Moss
• Fixed onboarding formula syntax and wiki links
• Fixed analytics not shutting down cleanly on quit

Highlights

Refreshed landing page design, plus stability improvements under the hood.

Bug Fixes

• Fixed download verification on some networks

Highlights

Comments now show whether they came from you or Moss, with distinct styling and a sprout icon for agent comments.

Improvements

• Update notifications now include a "Restart to update" button so updates actually install
• Note links resolve more reliably, including files with numbers or hyphens in the name
• Refreshed onboarding with new Getting Started and Use Cases guides

Bug Fixes

• Tables now handle code with pipe characters correctly
• Comments stay in place when switching between notes
• Improved comment reliability
• Update notification now shows the actual release highlights

Highlights

Formulas can now reference each other by name. Name a formula like revenue=1000*12, then use that name in another formula to pull in its value, with typeahead suggestions and hover preview.

What's New

• Named formula references. Give a formula a name, then type that name inside another formula to use its value
• Shareable note links. Copy a link to any note or heading, then paste it anywhere
• Obsidian import. Improved support for highlights, images, note links, and tables when importing from Obsidian

Improvements

• Comment mentions. Navigate @-mention suggestions with arrow keys
• Smarter slash menu. Exact matches show first
• Zen mode. Title bar and notes list appear on hover

Bug Fixes

• Fixed code block editing
• Fixed formula display and interaction
• Fixed table formatting on import
• General stability and save improvements

Highlights

Folder navigation is now more compact. Deeply nested folders collapse into a single row, so you can see more of your file tree without scrolling.

Improvements

• Cleaner folder design. Simplified the look of sub-folders

Bug Fixes

• Auto-updates on M-series Macs. Fixed an issue that could prevent automatic updates on newer Macs

Highlights

A more reliable editing experience with automatic refresh, smarter saving, and improved agent workflows.

What's New

• Automatic refresh. Notes update instantly when modified by the agent or another app
• Error notifications. Clear messages when something needs your attention

Improvements

• Smarter autosave. Saves happen more efficiently for a smoother experience
• Better multi-note editing. The agent can create and edit multiple notes without interrupting your focus
• Streamlined onboarding. Cleaner default skills and an improved Getting Started note

Highlights

The first public release of Moss. A private notebook where an AI agent writes directly into your notes.

Editor

• Rich text editing. Headings, tables, checklists, and code blocks
• Slash commands. Type / to insert tables, charts, images, sketches, formulas, and more
• Inline formulas. Math expressions appear as compact pills right in your text
• Note links. Type [[ to link notes together, with hover preview and click to navigate
• Charts. Bar, line, area, and donut charts from a simple data format
• Images and sketches. Drag and drop images, or open a drawing canvas inline
• Comments. Select text and press Cmd+Shift+A to leave a note

AI Agent

• Built-in AI agent. Press Cmd+K, describe what you need, and watch edits appear in real time
• Reads your whole workspace. The agent can reference other notes for richer answers
• Skills. Teach the agent reusable instructions for writing, research, and more

Interface

• Quick prompt. Cmd+K opens a search-style prompt with @-mention support
• Zen mode. Cmd+\ hides both panels for distraction-free writing
• Search. Instant filtering with keyboard navigation
• Trash with restore. Deleted notes go to trash with 30-day recovery

Platform

• Your files, your computer. Plain text files on your disk. No cloud, no account, no lock-in
• Open any .md file. Double-click a Markdown file in Finder to open it in Moss
• Auto-updates. New versions install automatically on next launch
• macOS 12+. Works on all modern Macs