overleaf-sync

Synchronize a local ARIS paper directory with an Overleaf project via Git bridge.

Updated May 25, 2026
One-click install
npx skills add https://github.com/duypham2801/ThS_LLM --skill overleaf-sync-duypham2801
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: overleaf-sync
Source: https://github.com/duypham2801/ThS_LLM/tree/main/.claude/skills/overleaf-sync
Command: npx skills add https://github.com/duypham2801/ThS_LLM --skill overleaf-sync-duypham2801

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of keeping a local ARIS paper workspace and an Overleaf project consistent while multiple collaborators edit across local and web environments.

Core Features & Use Cases

  • Two-way Overleaf Git bridge workflow: supports pulling Overleaf updates into the local paper workspace and pushing local changes back to Overleaf.
  • Diff-aware syncing: helps users avoid blindly syncing risky edits (like half-finished sentences or structural changes) by using a clear hunk-based decision approach.
  • Token-safe authentication: uses the Overleaf Git bridge setup so the agent never handles tokens, relying on OS keychain storage and token-free remotes; includes a pre-commit guard to prevent token-containing commits.

Use cases: preparing thesis sections with ARIS audits locally while co-authors refine prose in Overleaf; resolving review iterations by pulling Overleaf changes, selectively syncing safe edits locally, and then pushing the final results back.

Quick Start

Ask an AI to guide you to run the setup script in your own terminal for a given Overleaf project ID, then return to the chat and tell it “setup done” so it can verify the bridge is token-free.

Frequently Asked Questions about overleaf-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync a local paper directory with Overleaf while co-authors are editing online?

You can sync a local paper directory with Overleaf using the official Overleaf Git bridge workflow, enabling two-way pull and push synchronization with diff review to manage concurrent collaborator edits safely.

What is the best way to prevent authentication token leakage when using the Overleaf Git bridge?

To prevent authentication token leakage when using the Overleaf Git bridge, use OS keychain credential handling and token-free remotes, reinforced by pre-commit audit guards that block token-containing commits.

How does diff-based workflow help with collaborative thesis editing between local and Overleaf environments?

Diff-based workflow helps with collaborative thesis editing by applying a hunk-based decision approach, allowing you to selectively review and avoid blindly syncing risky or half-finished structural changes from Overleaf.

Can I use rsync mirroring alongside the Overleaf Git bridge for my thesis edits?

Yes, you can use optional rsync mirroring alongside the Overleaf Git bridge to synchronize your local paper workspace, pulling Overleaf updates and pushing finalized thesis sections back to the remote project.

Why does the Overleaf two-way sync use ff-only pull semantics?

Overleaf two-way sync uses ff-only pull semantics to enforce strict linear history integration, preventing unintended merge commits and providing clear divergence diagnostics when local and remote edits conflict.

Do I need to manually configure Git credentials to set up the Overleaf sync bridge?

No, you do not need to manually configure Git credentials; setup involves running a script for your Overleaf project ID that relies on OS keychain storage to ensure the bridge remains completely token-free.