overleaf-sync

Synchronizes local ARIS directories with Overleaf projects via Git bridge.

2|1|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/raja21068/AutoResearch --skill overleaf-sync-raja21068
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: overleaf-sync
Source: https://github.com/raja21068/AutoResearch/tree/main/skills/aris/overleaf-sync
Command: npx skills add https://github.com/raja21068/AutoResearch --skill overleaf-sync-raja21068

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents lost edits and citation/section drift by keeping your local ARIS paper directory synchronized with an Overleaf project using the Overleaf Git bridge.

Core Features & Use Cases

  • Two-way workflow (pull/push): Pull Overleaf changes into your local paper/ working copy and push local edits back to Overleaf after running audits.
  • Diff-aware syncing: Helps you avoid syncing half-finished sentences or structural edits by using a clear hunk decision protocol (including when to re-run /paper-claim-audit and /citation-audit).
  • Token-safe setup: Supports one-time authentication via OS keychain so the agent never handles or logs your Overleaf token, and includes a pre-commit guard to block token-shaped strings.

Quick Start

Tell the assistant: "setup <project-id>" to initialize the Overleaf Git bridge, then run "pull" before editing and "push" after ARIS updates are complete.

Frequently Asked Questions about overleaf-sync

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

FAQPage Schema
How do I sync local paper edits with Overleaf using Git?

To sync local paper edits with Overleaf, use the Overleaf Git bridge to pull remote changes into your local directory and push local updates back, preventing lost edits and citation drift.

How does token security work when connecting to the Overleaf Git bridge?

Token security is enforced by requiring interactive one-time authentication stored in the OS keychain, ensuring the agent never handles or logs your Overleaf token and includes a pre-commit guard to block token-shaped strings.

How do I avoid syncing half-finished sentences or structural edits to Overleaf?

To avoid syncing incomplete structural edits, use a diff-aware syncing protocol with clear hunk decisions to evaluate changes, which also indicates when to re-run paper claim and citation audits before pushing.

Can I run citation audits locally before pushing changes back to Overleaf?

Yes, you can pull Overleaf changes, run local citation and numbering validation audits on your working copy, and push the validated updates back to Overleaf once the audit loops are complete.

What happens if there are divergent edits between my local directory and Overleaf?

When divergent edits occur, the sync process runs status divergence checks and provides conflict-avoidance triggers to help you manage discrepancies between local updates and the remote Overleaf project.