overleaf-sync

Synchronize local ARIS LaTeX directories with Overleaf projects via Git bridge.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/Shallow-W/llm-wiki --skill overleaf-sync-shallow-w
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: overleaf-sync
Source: https://github.com/Shallow-W/llm-wiki/tree/main/.claude/skills/overleaf-sync
Command: npx skills add https://github.com/Shallow-W/llm-wiki --skill overleaf-sync-shallow-w

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Overleaf-based collaboration and local ARIS audit/edit workflows can drift apart, forcing you to manually reconcile edits across two copies of the same LaTeX project.

Core Features & Use Cases

  • Two-way Overleaf Git bridge syncing: Keeps a local working copy in sync with an Overleaf project using the official Overleaf Git bridge.
  • Safe direction control (pull vs push): Prevents accidental merges by treating local or remote as authoritative per session and requiring explicit direction changes.
  • Token security + workflow guards: Uses OS keychain for one-time auth and relies on technical safeguards (like a pre-commit hook) plus status checks to avoid token leakage and divergence.

Use cases:

  • Push your local ARIS-edited paper to Overleaf for co-author editing.
  • Pull collaborator changes from Overleaf into local paper/ before continuing audits.
  • Diagnose divergence when both sides may have changed.

Quick Start

Run the overleaf setup one time in your own terminal: bash <ARIS_REPO>/tools/overleaf_setup.sh <project-id-or-url>.

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 an Overleaf project?

Overleaf project syncing uses a two-way Git bridge and rsync to synchronize local LaTeX directories. It requires explicit pull or push workflows to safely reconcile local ARIS edits with remote collaborator changes.

How does the Overleaf Git bridge handle token security for local syncing?

Overleaf Git bridge token security uses the OS keychain for one-time authentication. It relies on a token-free git remote URL and technical safeguards like a pre-commit hook to prevent token leakage during local syncing operations.

What is the best way to prevent accidental merges during two-way Overleaf sync?

The best way to prevent accidental merges during two-way Overleaf sync is using safe direction control. This method treats either the local or remote repository as authoritative per session, requiring explicit pull or push direction changes to avoid conflicts.

How do I pull collaborator changes from Overleaf into my local LaTeX repository?

To pull collaborator changes from Overleaf into a local LaTeX repository, initiate an explicit pull workflow via the Git bridge. This action updates your local working copy with the latest remote project files before you continue auditing.

Can I diagnose divergence when both local and Overleaf repositories have changed?

Yes, you can diagnose divergence when both local and Overleaf repositories have changed. The sync workflow includes built-in divergence detection with status checks to identify conflicting edits before you push or pull files.

Do I need to set up the Overleaf Git bridge manually before syncing local papers?

Yes, you need to run a setup script in your terminal one time to configure the Overleaf Git bridge. This initial step links your local ARIS repository to the remote project using a token-free git remote URL.