Back to home

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.