skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
aloth/overleaf-skill177 installs

overleaf

Sync and manage Overleaf LaTeX projects from the command line. Pull projects locally, push changes back, diff against Overleaf, make a marked-up latexdiff PDF, use Overleaf as a git remote, compile PDFs, and download compile outputs like .bbl files for arXiv submissions. Works on the free Overleaf plan. Use when working with LaTeX, Overleaf, academic papers, or arXiv.

How do I install this agent skill?

npx skills add https://github.com/aloth/overleaf-skill --skill overleaf
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The Overleaf skill enables management of LaTeX projects on Overleaf through the olcli command-line interface, supporting workflows for project synchronization, PDF compilation, and arXiv submissions.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

  • Runlayerwarn

    6/6 files flagged

  • ZeroLeakspass

    1 finding · Score: 86/100

What does this agent skill do?

Overleaf Skill

Manage Overleaf LaTeX projects via the olcli CLI.

Installation

# Homebrew (recommended)
brew tap aloth/tap && brew install olcli

# npm
npm install -g @aloth/olcli

Authentication

Sign in once through a browser window (needs olcli 0.16 or newer and Node 22 or newer). Works with SSO and two-factor logins; olcli keeps only the session cookie:

olcli auth --browser

Without a display (a server, a container), paste the session cookie instead: log into overleaf.com, open DevTools (F12), Application, Cookies, and copy the value of overleaf_session2:

olcli auth --cookie "YOUR_SESSION_COOKIE"

Check the setup (exits 1 when not signed in, so olcli auth status || olcli auth --browser signs in only when needed):

olcli auth status

Clear stored credentials:

olcli logout

Common Workflows

Pull a project to work locally

olcli pull "My Paper"
cd My_Paper/

Edit and sync changes

# After editing files locally
olcli push              # Upload changes only
olcli sync              # Bidirectional sync (pull + push)

See what a push would change

olcli diff                     # unified diff against Overleaf as it is right now
olcli diff --name-only         # just the changed paths
olcli diff --latexdiff --pdf   # marked-up PDF of the revision, compiled on Overleaf

olcli push replaces whole files on Overleaf. Run olcli diff first when coauthors edit the same project.

Use Overleaf as a git remote

git clone overleaf::https://www.overleaf.com/project/<id> paper
cd paper
git pull                       # bring in coauthors' edits
git commit -am "Rewrite results"
git push                       # refused while Overleaf has edits you have not pulled

Needs olcli 0.16.1 or newer. If a push is refused, run git pull, resolve any conflict, commit and push again. git push --force overwrites Overleaf on purpose.

Compile and download PDF

olcli pdf                      # Compile and download
olcli pdf -o paper.pdf         # Custom output name
olcli compile                  # Just compile (no download)

Download .bbl for arXiv submission

olcli output bbl               # Download compiled .bbl
olcli output bbl -o main.bbl   # Custom filename
olcli output --list            # List all available outputs

Upload figures or assets

olcli upload figure1.png "My Paper"          # Upload to project root
olcli upload diagram.pdf                      # Auto-detect project from .olcli.json

Download specific files

olcli download main.tex "My Paper"           # Download single file
olcli zip "My Paper"                          # Download entire project as zip

arXiv Submission Workflow

Complete workflow for preparing an arXiv submission:

# 1. Pull your project
olcli pull "Research Paper"
cd Research_Paper

# 2. Compile to ensure everything builds
olcli compile

# 3. Download the .bbl file (arXiv requires .bbl, not .bib)
olcli output bbl -o main.bbl

# 4. Download any other needed outputs
olcli output aux -o main.aux    # If needed

# 5. Package for submission
zip arxiv.zip *.tex main.bbl figures/*.pdf

# 6. Verify the package compiles locally (optional)
# Then upload arxiv.zip to arxiv.org

Commands Reference

CommandDescription
olcli auth --browserSign in through a browser window
olcli auth --cookie <value>Authenticate with session cookie
olcli auth statusCheck authentication status and credential source
olcli logoutClear stored credentials
olcli listList all projects
olcli info [project]Show project details
olcli pull [project] [dir]Download project files
olcli push [dir]Upload local changes
olcli sync [dir]Bidirectional sync
olcli diff [project] [dir]Diff local files against Overleaf (--latexdiff --pdf for a marked-up PDF)
olcli upload <file> [project]Upload a single file
olcli download <file> [project]Download a single file
olcli zip [project]Download as zip archive
olcli compile [project]Trigger compilation
olcli pdf [project]Compile and download PDF
olcli output [type]Download compile outputs

Tips

  • Auto-detect project: Run commands from a synced directory (contains .olcli.json) to skip the project argument
  • Dry run: Use olcli push --dry-run to preview changes before uploading
  • Force overwrite: Use olcli pull --force to overwrite local changes
  • Project ID: You can use project ID instead of name (24-char hex from URL)
  • Debug auth: Run olcli auth status to see the account and where credentials are loaded from
  • Before a push: Run olcli diff to see what the push would overwrite

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/aloth/overleaf-skill/overleaf">View overleaf on skillZs</a>