overleaf-sync

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

1|1|Updated May 19, 2026
One-click install
npx skills add https://github.com/zhuyingqin/ARIS-WEB --skill overleaf-sync-zhuyingqin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: overleaf-sync
Source: https://github.com/zhuyingqin/ARIS-WEB/tree/main/crates/runtime/assets/skills/overleaf-sync
Command: npx skills add https://github.com/zhuyingqin/ARIS-WEB --skill overleaf-sync-zhuyingqin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Overleaf collaboration can drift from your local ARIS working papers, forcing repetitive manual copy-paste or risky merges; this Skill keeps them aligned.

Core Features & Use Cases

  • Two-way Git bridge workflow: sync a local paper/ directory with an Overleaf project clone (paper-overleaf/) using Overleaf’s official Git bridge.
  • Token-safe authentication guidance: supports one-time user auth via OS credential storage (macOS Keychain / platform helper) so the agent never handles tokens.
  • Diff-and-guard sync modes: provides pull, push, and status guidance plus a conflict/divergence protocol to prevent destructive resolution.

Quick Start

Ask the agent to run: setup paper-overleaf project-id.

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 LaTeX paper directory with Overleaf?

Overleaf's Git bridge allows two-way sync by cloning your project into a local directory and using rsync to align files, preventing manual copy-paste and risky merges.

Can I use Overleaf Git bridge for two-way collaborative editing workflows?

Yes, the Overleaf Git bridge supports two-way collaborative editing workflows by pulling remote changes before local edits and pushing local edits after audits.

How does token security work when connecting to Overleaf via Git?

Token security is maintained by using OS credential storage like macOS Keychain for one-time authentication, ensuring the agent never handles the token directly.

What is the best way to handle divergence and conflicts during Overleaf sync?

Handle divergence and conflicts by running diagnostic status checks and following an explicit divergence protocol to prevent destructive resolution during Overleaf sync.

Do I need rsync to push local edits to Overleaf after a citation audit?

Yes, rsync is required to push local edits to Overleaf after a citation audit, as it syncs your local paper directory with the cloned Overleaf project.

Why does pre-commit token pattern blocking matter for LaTeX collaboration?

Pre-commit token pattern blocking matters for LaTeX collaboration because it enforces safety guards that prevent accidentally committing sensitive authentication tokens.