Sync and manage Overleaf LaTeX projects from the command line. Pull projects locally, push changes back, compile PDFs, and download compile outputs like .bbl...
Manage Overleaf LaTeX projects via the olcli CLI.
# Homebrew (recommended)
brew tap aloth/tap && brew install olcli
# npm
npm install -g @aloth/olcli
Get your session cookie from Overleaf:
overleaf_session2olcli auth --cookie "YOUR_SESSION_COOKIE"
Verify with:
olcli whoami
olcli pull "My Paper"
cd My_Paper/
# After editing files locally
olcli push # Upload changes only
olcli sync # Bidirectional sync (pull + push)
olcli pdf # Compile and download
olcli pdf -o paper.pdf # Custom output name
olcli compile # Just compile (no download)
olcli output bbl # Download compiled .bbl
olcli output bbl -o main.bbl # Custom filename
olcli output --list # List all available outputs
| 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 |
.olcli.json) to skip the project argumentolcli push --dry-run to preview changes before uploadingolcli pull --force to overwrite local changesGet a fresh cookie from the browser and run olcli auth again.
Check the Overleaf web editor for detailed error logs.
ZIP package — ready to use