npm version npm downloads GitHub stars MIT License

Overleaf,
from your terminal.

Work on Overleaf projects from your terminal while your coauthors keep using the Overleaf web editor. Works on the free plan and on self-hosted Community Edition, with no git token.

Homebrew
brew install aloth/tap/olcli
Click to copy
npm
npm install -g @aloth/olcli
Click to copy
olcli: zsh
$ olcli auth --browser
ok: Authenticated! Found 12 projects.
$ olcli pull "Conference Paper" paper
ok: Downloaded 12 files to paper/
$ cd paper && vim main.tex
$ olcli diff --name-only
M main.tex
$ olcli push
ok: Uploaded 1 file(s) to "Conference Paper"
$ olcli diff --latexdiff --pdf
.olcli-diff/main-diff.pdf
$ olcli comments list --status open
Found 3 comment(s):

Everything you need

Your editor, your scripts and your agents on one side; your coauthors in the browser on the other.

๐Ÿ‘ฅ

Coauthors Change Nothing

They keep editing, commenting and compiling in the Overleaf web editor. You pull, edit locally and push to the same project.

๐Ÿ†“

Free Plan and Self-Hosted

Checked on a free overleaf.com account. Works on self-hosted Community Edition with olcli config set-url. No git token needed.

๐Ÿ”‘

Browser Sign-In

olcli auth --browser works with SSO, Google, ORCID and two-factor logins and keeps only the session cookie. Or paste the cookie at a hidden prompt.

๐Ÿ”„

Pull, Push, Sync, Diff

Diff against the live project before you push, so a coauthor's newer edit shows up first. --exit-code turns it into a CI gate.

๐Ÿ“

Marked-Up Revisions

olcli diff --latexdiff --pdf builds the struck-through and underlined PDF advisors and journals ask for, compiled on Overleaf.

๐Ÿ’ฌ

Comments and Tracked Changes

List, add, reply to and resolve comments. Accept or reject tracked changes in projects whose owner has an Overleaf premium plan.

๐Ÿค–

MCP Server, Asks First

Claude Code, Codex and Cursor can read and edit your projects. Every tool that writes shows what it will do and waits for your confirmation.

๐Ÿ”€

Native Git Remote

git clone overleaf::<url> uses Overleaf as a standard git remote. Clone, commit and push with the commands you already know.

๐Ÿ“„

Remote Compilation

Compile on Overleaf's servers, download the PDF or outputs such as .bbl for arXiv. No local TeX installation needed.

Why olcli?

olcli
Overleaf Web
Use any editor
โœ“
โœ—
Git workflow
โœ“ free plan
Premium only
Offline editing
โœ“
โœ—
CI/CD automation
โœ“
โœ—
AI agent integration
โœ“ MCP, asks first
โœ—
Cloud compilation
โœ“
โœ“
Real-time collab
Coauthors stay in the web editor
โœ“

Common workflows

๐Ÿ”‘ First run

Sign in through a browser window, or paste the session cookie at a hidden prompt.

olcli auth --browser
olcli auth --cookie
olcli auth status

๐Ÿข Self-hosted Overleaf

Set the URL of your Community Edition instance once.

olcli config set-url https://latex.example.org
olcli config set-cookie-name overleaf.sid
olcli auth --browser

๐Ÿ“ Daily thesis work

Edit locally, check what changed on Overleaf, sync and compile.

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

๐Ÿ–๏ธ Revision for your advisor

Mark your local revision up inside the document and compile it on Overleaf.

olcli diff --latexdiff --pdf

๐Ÿ”€ Git clone & push

Use Overleaf as a native git remote, without a git token.

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

๐Ÿ“ฎ 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 ๐Ÿ“ Diff and latexdiff ๐Ÿ“ฆ npm