Features

Moss is a local-first workspace for thinking, building, and working with agents. Write in Markdown, create interactive product artifacts, and let agents work directly in the files you own.

Work with the built-in Moss Agent inside a note, or let coding agents edit your notes directly as files.

The Built-in Moss Agent

The Moss Agent works across your notes without leaving the editor. It is powered by Claude Code.

The Moss Agent requires Claude Code to be installed and signed in. Set it up · How credentials work · Fix agent issues

Create an Action

An Action tells the Moss Agent what to do and which context to use. Press ⌘K, describe the result you want, then press ⌘Enter. Moss starts working, applies any requested changes or comments to the note, and records its progress and result in the Actions panel.

Add context

• Select text before pressing ⌘K to include it in your prompt.
• Type @ to reference specific notes or folders.
• Click to upload images.
• Click to have the Moss Agent generate and embed HTML in the note.

Position the Action Composer

• Drag to move the floating Action Composer.
• Click to dock it in the Actions panel and keep it visible while you edit a note.

Moss & Coding Agents

Claude Code, Codex, Cursor, and other coding agents can edit Moss notes directly as files.

• Click Share with Agent at the top of a note to copy the active note path and Moss editing instructions for another agent.
• Moss Skills are available at ~/Moss/.moss/skills/. Install the Moss Skills repository to load them automatically in future sessions.

Comments

Keep feedback anchored to the exact text or block it describes, then continue the discussion without losing the surrounding context.

• Select content and press ⌘⇧A, or click in the floating toolbar.
• Reopen a highlight to reply, edit, resolve, delete, or send the thread to the Moss Agent.

Moss combines rich-text editing with formulas, variables, colors, diagrams, prototypes, charts, and media. These stay editable inside the note instead of becoming separate attachments or tools.

Formulas and Variables

Type /formula or /variable to add calculated or reusable values that update wherever they are referenced.

Copy and paste a variable in the same note to create another linked instance. Renaming it or changing its value updates every instance. Type a new name=value variable to create an independent value; pasting into another note also creates an independent variable.

Names start with a letter and may include letters, numbers, hyphens, and underscores. Formats are inferred automatically: $ prefix for currency, % suffix for percent, decimals for division. Press Backspace to convert a formula or variable back to text.

Color Picker & Color Previews

Preview and edit CSS colors inline.

• Type /color, or begin a HEX, rgb( / rgba(, or hsl( / hsla( value.
• Select a color pill to edit it.

Canvas

Sketch wireframes, flows, diagrams, and annotations beside your writing.

• Type /canvas to add a canvas and get started.

Embedded HTML

Add interactive prototypes, dashboards, and visualizations to a note.

• Type /html to add an HTML block.
• Click in the Action Composer to have the Moss Agent create one.
• Activate the rendered preview inline or expand it.

Web Embeds & In-App Browser

Keep public webpages inside a note or open them beside it without leaving Moss.

• Typing or pasting a public URL creates a web pill. Click the pill to open an interactive preview over the note.
• Click the in the top-right of the preview to open the page in a browser tab beside your note.
• Press ⌘⇧T to open a browser tab beside the current note.
• [Title](url) creates a normal hyperlink. ![Title](url) turns a link into a visual embed that lives inside the note.

Charts

Add editable charts beside the analysis they support.

• Type /chart, or ask an agent to create one.
• Choose bar, line, area, or stacked bar and edit the data inline.

Images and Video

Keep images, recordings, and video references beside your writing.

• Type /media, paste, or drag from Finder.
• Moss supports PNG, JPG, GIF, WebP, SVG, local MP4/WebM/MOV files, HTTPS image URLs, and YouTube links.

Connected Folders

Give the Moss Agent read-only access to files outside your notes without moving or copying them.

• Connect a folder from Settings.
• Type @ to add its files as context.
• Moss keeps a folder listing for browsing and reads content only on demand. It cannot modify connected files.

External Folders

Edit existing Markdown folders, including Obsidian vaults, with the full Moss editor.

• Open a folder or Markdown file from its current location.
• Files are not imported, copied, or converted.
• Changes save to the originals.

Wiki Links

Connect notes and headings without leaving your current context.

• Type [[ or /link to search for a note. Add # to target a heading.
• Click in the top nav, then paste the note link into another note.
• Hover to preview, select to open, or right-click for a new window or split view.

Split View & Windows

Keep two independently navigable notes side by side, or open another Moss window.

• Right-click a note or Wiki Link and choose Open in Split Tab.
• Each pane keeps its own navigation history.
• Choose File → New Window or press ⌘⇧N for another window.

Default Properties

Keep note metadata current automatically or edit it yourself.

• Every note gets a created_date.
• Enable Settings → Note Intelligence to infer an editable description, tags, and status.
• Select a tag to find its mentions in the active note.

Related Notes

Find likely connections based on folder context, titles, and tags.

• Open Related Notes from the right panel.
• Backlinks remain separate, and External notes are excluded.

Sidebar & Navigation

Pinned Notes

Keep selected notes in a collapsible section at the top of the sidebar.

• Right-click a note, or click on hover.
• Nested notes include their folder breadcrumb.

Add structure with blocks, headings, lists, tables, callouts, tabs, and code.

Slash Commands

Type / to add blocks or quick inserts such as /date, /day, /month, and /emoji.

/

Inline

Date

Insert current date

Day

Insert current day of week

Month

Insert current month

Emoji

Open the system emoji picker

Headings

Four levels. Type #, ##, ###, or #### at the start of a line, or use the heading menu in the toolbar.

Project Overview

Research Phase

Key Findings

Lists

Bullet lists, numbered lists, and checklists. Use markdown list syntax, toggle a checklist with ⌘⇧C, and indent with Tab.

Bullet list

• Research methodology
• Data collection
  • Primary sources
  • Secondary sources
• Analysis

Numbered list

1. Define hypothesis
2. Gather data
3. Analyze results
4. Write conclusion

Checklist

Draft introduction

Review references

Write conclusion

Dividers

Type --- on its own line to insert a horizontal rule.

Quotes

Type > at the start of a line or use /quote.

Quote

“The only way to do great work is to love what you do.”

— Steve Jobs

Callouts

Highlight information that should stand apart from the note.

• Type /callout.
• Click in the header to choose Info, Warning, or Priority.
• Priority callouts can include a level.

Tabs

Keep related sections in one compact group.

• Type /tabs to create a group.
• Double-click a label to rename it, or open for tab actions.
• Drag separators to resize titles; drag titles to reorder them.
• Use Keep this tab only or Delete from that menu.

Code Blocks

Type /code, then choose a language and theme. Code blocks include syntax highlighting, labels, and line numbers.

Tables

Type /table to insert a grid with a header row. Tab moves between cells. Add or remove rows and columns from the toolbar that appears when a cell is selected.

Feature	Status	Notes
Rich text editing	Shipped	Bold, italic, highlights, links
Inline formulas	Shipped	Named references, cross-note
Charts	Shipped	Bar, line, area, stacked bar
Comments	Shipped	Inline feedback, agent handoff