overleaf-review can now fully replace Overleaf's Git/GitHub sync — which is what you want, because that sync is what destroys your review layer.
Why
Overleaf's Git integration writes documents by wholesale content replacement. Comments and tracked changes are anchored by character offsets, so a bulk overwrite orphans or displaces them. overleaf-review writes through the real-time OT API instead — incremental ops that Overleaf transforms the review ranges against, so the review layer survives.
Added
fetch [--file <f>] [--dry-run]— write Overleaf's current text down into your local files. Read-only on Overleaf: it cannot disturb a comment or tracked change.upload <path…> [--folder <name>]— upload figures, PDFs, or new files into Overleaf (re-uploading the same name replaces it).push --direct— send plain edits instead of tracked suggestions. Still range-safe (OT transforms existing ranges), and it's what actually replaces the bridge's job.
Recommended setup
Unlink Overleaf's Git/GitHub sync and let overleaf-review be the only bridge: fetch text down, push / push --direct text up, upload figures up. Your Git repo becomes a normal repo with nothing bidirectional that can clobber the review record.
npm install -g overleaf-review