overleaf-local-sync

Installation
SKILL.md

Overleaf Local Sync

Synchronize the requested manuscript changes while retaining edits made on either side. Default to the browser workflow when the user requests edits “as a human,” incremental changes, or preservation of Overleaf review history. Reuse an established Overleaf Git workflow when available and consistent with the user's request; fetch and merge, never force-push or replace the project to resolve divergence.

Establish the comparison

  1. Identify the local manuscript root, exact Overleaf project, authorized browser session, and requested changes. Reuse the existing project tab and desktop. Record project URLs, account details, browser endpoints, and snapshots in private or ignored state, outside submission packages.
  2. Inspect local Git status. Preserve current work with a scoped commit/tag when requested or established by the project; otherwise use a private source snapshot. Do not sweep unrelated files into a commit.
  3. Download fresh Overleaf source before editing. Preserve unsaved browser text before reloading an offline or out-of-sync editor; cached editor contents are not proof of current server state. Read browser-workflow.md for source downloads, recovery, and UI edits.
  4. Identify the last verified common baseline, B, current local files, L, and fresh remote source, R. Explicitly map local and Overleaf filenames and normalize only known path tokens for comparison. Read comparison-helper.md to use the bundled read-only planner.
Comparison Action
L = R Already converged; keep the content.
L = B; R changed Pull the remote edit into local.
R = B; L changed Stage the local edit for Overleaf.
Both changed differently Review a three-way text merge; preserve both changes where compatible.
Binary conflict, missing file, or overlapping edits Resolve the specific conflict; do not guess from timestamps or silently delete.
No verified baseline Compare and reconcile explicitly. A new remote download alone is not a common baseline.
Installs
1
GitHub Stars
1
First Seen
Oct 19, 2026