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.