Markdown Note Sync CLI

Keep your notes in Markdown. Sync them anywhere. No proprietary formats.

Problem

I take notes in Markdown across multiple machines. I wanted something simpler than Obsidian Sync — just a CLI that diffs and pushes changes.

Commands

# Initialize sync config
mnotes init --remote user@server:/notes

# Sync (two-way)
mnotes sync

# Show diff before syncing
mnotes diff

How it works

1. Hash every local .md file
2. Compare with remote hash index
3. Push new/changed files, pull remote-only files
4. Conflict = keep both with timestamp suffix

Dependencies

• paramiko — SSH
• watchdog — optional auto-sync on file change

Status

v0.2.1 — stable for two machines. Three-way sync is future work.