Guides

Set up Moss Agent, import existing notes, and manage the local files Moss uses.

Moss Agent is the AI built into Moss, and it is powered by Claude Code. For product workflows and examples, open the in-app Use Cases note. For a visual overview of what Moss can do, see Features.

AI in Moss

Set Up Moss Agent

Install and sign in to Claude Code, which powers the built-in Moss Agent.

Troubleshoot Claude Code + Moss

Fix the most common setup and sign-in problems when AI in Moss is not working.

Import

Import Notes into Moss

Choose the right path for Notion, Obsidian, or other Markdown notes.

Import from Notion

Export your pages as Markdown, then open the unzipped folder in Moss.

Import from Obsidian

Open your Obsidian vault directly in Moss and keep using the same files.

Workspace

Back Up and Sync

Pick the right guide for folders that already sync, syncing local Moss notes to the cloud, or using Git.

Open a Synced Markdown Folder

Open Markdown files where they already live in Dropbox, iCloud, or another folder.

Sync Local Moss Workspace

Connect your current Moss workspace to Dropbox, iCloud Drive, or OneDrive, then point Moss to that synced copy.

Use Git with Moss Notes

Use your normal Git workflow with Moss files if Git is already part of your workflow.