overleaf
Sync, manage, and compile Overleaf LaTeX projects from the command line. Pull, push, sync, and download PDFs or .bbl files for arXiv submissions.
Introduction
The Overleaf CLI skill allows researchers, students, and academics to manage their LaTeX projects directly from the terminal. By integrating with Overleaf's backend, it eliminates the need to manually navigate the web interface for routine tasks like compiling documents, uploading figures, or preparing submissions for arXiv. This tool is designed for users who prioritize version control, local environment integration, and efficient paper management workflows. It serves as a bridge between local file editing and the Overleaf cloud ecosystem.
-
Project Management: Authenticate securely via session cookies, list all projects, and fetch project metadata using the olcli tool.
-
Seamless Synchronization: Perform pull, push, and full bidirectional sync operations to keep your local workspace consistent with the cloud.
-
Advanced Compilation: Trigger remote compilation of LaTeX files and download resulting PDFs or specific build artifacts like .bbl, .aux, and .log files.
-
Submission Support: Streamline arXiv submissions by programmatically generating and downloading the specific bibliography (.bbl) and auxiliary files required by submission platforms.
-
Asset Handling: Rapidly upload figures, images, and other resources to your project root or auto-detected directories.
-
Project Automation: Supports project auto-detection via .olcli.json files, making it easy to manage multiple papers without specifying the project ID repeatedly.
-
Prerequisites: Requires an active Overleaf account and the olcli CLI tool installed via Homebrew or npm.
-
Authentication: Manages credentials securely using standard session cookies. Users should ensure their authentication token is kept confidential.
-
Usage constraints: This skill is intended for LaTeX document development and management; it does not replace a full LaTeX distribution (e.g., TeX Live) for local compilation but manages the remote compilation cycle.
-
Optimization: Users can take advantage of flags like --dry-run for previews or --force for strict overwriting to prevent accidental data loss during sync operations.
Repository Stats
- Stars
- 4,437
- Forks
- 1,203
- Open Issues
- 7
- Language
- Python
- Default Branch
- main
- Sync Status
- Idle
- Last Synced
- Apr 29, 2026, 12:41 PM