npm version npm downloads GitHub stars MIT License

Overleaf,
from your terminal.

Pull, push, sync, and compile LaTeX projects without leaving your editor. Native git remote. MCP server for AI agents. Works with CI/CD.

Homebrew
brew install aloth/tap/olcli
Click to copy
npm
npm install -g @aloth/olcli
Click to copy
olcli — zsh
$ olcli pull "Conference Paper" paper
✓ Pulled 12 files to ./paper/
$ vim paper/main.tex
$ olcli sync
✓ Pushed 1 file · Pulled 0 files · PDF compiled

# Or use native git commands:
$ git clone overleaf::https://www.overleaf.com/project/abc123
Cloning into 'abc123'...
$ cd abc123 && echo "Hello from git" >> main.tex
$ git add . && git commit -m "update intro"
$ git push
✓ Uploaded 1 file to Overleaf
To overleaf::https://www.overleaf.com/project/abc123

Everything you need

Full Overleaf access without opening a browser.

🔀

Native Git Remote

git clone overleaf::<url> — use Overleaf as a standard git remote. Clone, pull, push with the commands you already know.

🔄

Bidirectional Sync

Smart conflict detection. Local wins if newer, remote changes pulled automatically. Local deletions propagate to Overleaf.

🤖

MCP Server

Built-in Model Context Protocol server. Claude Desktop, Cursor, and Windsurf can manage your LaTeX projects directly.

📄

Remote Compilation

Compile PDFs using Overleaf's servers. Download output artifacts (.bbl, .log) for arXiv submissions.

✏️

Your Editor, Your Way

Vim, VS Code, Emacs, Sublime — edit locally in whatever you're fastest with.

🚫

Smart Ignore

LaTeX build artifacts filtered automatically. Customize with .olignore (gitignore syntax).

📦

arXiv Workflow

Download .bbl files, create submission zips, and prepare camera-ready papers from CLI.

🔐

Flexible Auth

Session cookie, env var, .olauth file, or password login. Works in CI/CD pipelines and self-hosted instances.

Why olcli?

olcli
Overleaf Web
Use any editor
✓
✗
Native git workflow
✓
Premium only
Offline editing
✓
✗
CI/CD automation
✓
✗
AI agent integration
✓ MCP
✗
Cloud compilation
✓
✓
Real-time collab
✗
✓

Common workflows

🔀 Git clone & push

Use Overleaf as a native git remote. Standard workflow, zero learning curve.

git clone overleaf::https://www.overleaf.com/project/abc123
cd abc123
vim main.tex
git add . && git commit -m "edits"
git push

📝 Daily thesis work

Edit locally, sync when ready, compile to check output.

olcli pull "PhD Thesis" thesis
vim thesis/chapters/results.tex
olcli sync
olcli pdf -o draft.pdf

📮 arXiv submission

Download compiled artifacts and package for upload.

olcli output bbl -o main.bbl
olcli zip -o arxiv-submission.zip

💾 Backup all projects

One-liner to archive every project as a zip.

olcli list --json | jq -r '.[].name' \
| xargs -I{} olcli zip "{}" -o "{}.zip"

Start using olcli

Free, open source, MIT licensed. Install in 10 seconds.

Install via npm View on GitHub
📖 README 🔀 Git Remote 🤖 MCP Server 📦 npm