Document Sync

Document sync keeps notes and docs synchronized with Postgram entities.

What this page covers

How to run directory sync, how the manifest protocol works, and what to expect on large repositories.

Core workflow

1. Run sync against a directory:

pgm sync ~/Documents/personal-notes

2. Optionally set repository name:

pgm sync ~/Documents/cf-notes --repo cf-notes --quiet

3. Postgram sync protocol:

   • POST /api/sync/diff to compare file hashes,
   • batched POST /api/sync/upload,
   • POST /api/sync/finalize to archive stale documents.

4. Check repository state:

curl http://127.0.0.1:3100/api/sync/status/personal-notes \
  -H "Authorization: Bearer $PGM_API_KEY"

Notes

• The CLI walks .md files recursively and computes SHA-256 hashes locally.
• Batches are capped to protect large payload size.
• Use --dry-run for safe validation before upload.