Overleaf CLI (olcli)

这是olcli命令行工具，核心功能包括同步Overleaf LaTeX项目（拉取本地、推送修改、双向同步）、编译PDF、下载.bbl等编译输出。典型场景为本地编辑LaTeX学术论文、准备arXiv投稿文件。需先通过Overleaf会话cookie认证，输入为命令行指令及参数，输出为同步的本地文件、PDF或指定编译产物，支持自定义输出文件名。

aloth

热度 53.87

最近更新 2026-05-11 17:29:24

分类：效率依赖：纯提示词应用场景：研究 / 文件转换 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add olcli

Metadata

name: overleaf
description: Sync and manage Overleaf LaTeX projects from the command line. Pull projects locally, push changes back, compile PDFs, and download compile outputs like .bbl files for arXiv submissions. Use when working with LaTeX, Overleaf, academic papers, or arXiv.
license: MIT
metadata: {"author":"aloth","version":"1.0","cli":"olcli","install":"brew tap aloth/tap && brew install olcli"}

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

Get your session cookie from Overleaf:

Log into overleaf.com
Open DevTools (F12) → Application → Cookies
Copy the value of overleaf_session2

olcli auth --cookie "YOUR_SESSION_COOKIE"

Verify with:

olcli whoami

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)

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

Commands Reference

Command	Description
`olcli auth --cookie <value>`	Authenticate with session cookie
`olcli whoami`	Check authentication status
`olcli list`	List 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 upload <file>`	Upload a single file
`olcli download <file>`	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)

Troubleshooting

Session expired

Get a fresh cookie from the browser and run olcli auth again.

Compilation fails

Check the Overleaf web editor for detailed error logs.