overleaf-sync

Sync local paper directories with Overleaf projects via Git bridge.

Updated Apr 29, 2026
One-click install
npx skills add https://github.com/jkfee/Auto-Research --skill overleaf-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: overleaf-sync
Source: https://github.com/jkfee/Auto-Research/tree/main/skills/overleaf-sync
Command: npx skills add https://github.com/jkfee/Auto-Research --skill overleaf-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bridge a local paper directory with an Overleaf project so ARIS audits can run locally while collaborators edit in Overleaf. The token never leaves the agent — the user performs a one-time authentication via macOS Keychain to keep credentials secure.

Core Features & Use Cases

  • Two-way sync between paper/ and Overleaf via the Overleaf Git bridge (Premium feature).
  • ARIS can read changes, run audits (/paper-claim-audit, /citation-audit, /auto-paper-improvement-loop), and push fixes back to Overleaf.
  • Security-first workflow: token never stored in chat history or files; one-time setup primes the OS keychain.

Quick Start

Run the one-time setup script in your terminal to configure the Overleaf bridge, then use pull to fetch changes and push to publish local edits.

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 for collaborative editing?

To sync a local directory with Overleaf, you use the Overleaf Git bridge to establish two-way synchronization. This allows local audits to run while collaborators edit in Overleaf, pushing fixes back to the remote project.

How does token security work when bridging Overleaf with a local agent?

Token security relies on a one-time macOS Keychain authentication. The token never leaves the agent or gets stored in chat history and files, requiring a non-chat workflow for initial entry to keep credentials secure.

Do I need an Overleaf Premium account to use the Git bridge for paper syncing?

Yes, bridging local paper data with Overleaf requires the Overleaf Git bridge, which is a Premium feature. You need premium access to utilize the two-way synchronization mechanism for your research project.

What kind of local audits can I run on papers synced from Overleaf?

You can run ARIS audits such as paper-claim-audit, citation-audit, and auto-paper-improvement-loop. These audits read changes from Overleaf and push fixes back across both surfaces.

What are the limitations of using macOS Keychain for Overleaf authentication?

The macOS Keychain authentication requires a macOS environment and a non-chat workflow for the one-time setup script. It is limited to operating within the macOS Keychain infrastructure, which may not suit cross-platform users.