moss
Features
PrinciplesPricing
Download
moss

Product

  • Features
  • Pricing
  • Download

Moss for

  • Developers
  • Writers
  • Researchers
  • Product Managers
  • Everyday Life

Resources

  • Getting Started
  • Import Notes
  • Release Notes
  • Design Principles
  • Support
  • Security

Legal

  • Privacy
  • Terms

Connect

  • Twitter / X

© 2026 Moss.

Back to home
Getting Started
Troubleshoot Claude Code
Import Notes
Backup and Sync
Open a Synced Markdown Folder
Sync Local Moss Workspace
Use Git with Moss Notes
Notes already in Git
Add Git to Moss notes
What to expect

Use Git with Moss Notes

Use this only if Git is already part of how you work.

How it works: Git tracks changes to files. Moss notes are files, so they work with Git like other Markdown files do.
1

If your notes already live in Git

In Moss, use File → Open... and choose the Git repo folder that already contains those notes.

Moss opens those notes under External.

When you edit in Moss, Moss saves back to the same files Git already tracks.

2

If your Moss notes are local today

Open the folder Moss is using as its workspace in the Terminal app. If you have not changed it, that folder is usually ~/Moss.

Start Git there with git init.

After that, use your normal Git workflow from that same folder.

3

What to expect

Git tracks changes to the files Moss edits. Moss does not run git add, git commit, or git push for you.

Commit note folders and any matching asset folders together so a note still works when you restore it later.

Git is useful for version history and backup when you push to a remote. It is not the same thing as automatic cloud sync.