olcli CLI
CLI для Overleaf: вытягивает проекты LaTeX в папку, отправляет правки, компилирует PDF и отдает их агенту через MCP
- 243 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Cookie сессии Overleaf открывает весь аккаунт: проекты, файлы и комментарии
- `olcli sync` и `push --delete` удаляют на Overleaf файлы, которых нет локально
- Тексты документов и комментарии пишут соавторы, и агент получает их как данные, где могут быть чужие инструкции
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/olcliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Cookie сессии Overleaf открывает весь аккаунт: проекты, файлы и комментарии
- `olcli sync` и `push --delete` удаляют на Overleaf файлы, которых нет локально
- Тексты документов и комментарии пишут соавторы, и агент получает их как данные, где могут быть чужие инструкции
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
olcli работает с проектами Overleaf из терминала. Команда `olcli pull` скачивает проект в локальную папку, `olcli push` отправляет изменения, `olcli sync` объединяет обе стороны и переносит на Overleaf удаления, сделанные локально. `olcli pdf` собирает PDF на компиляторе Overleaf, поэтому локальная установка TeX Live ни к чему. Команда `olcli output` скачивает `.bbl`, `.log` и `.aux` для отправки в arXiv. Есть команды для комментариев рецензентов, отслеживаемых правок, загрузки и переименования файлов, а также поддержка собственных серверов Overleaf и ShareLaTeX. `olcli diff` сравнивает локальные файлы с живым проектом: флаг `--latexdiff` готовит версию с зачеркнутыми и подчеркнутыми правками, а `--exit-code` превращает проверку в условие для CI. Overleaf подключается и как git remote: `git clone overleaf::https://www.overleaf.com/project/<id>`. Для агентов есть скилл (`npx skills add aloth/olcli`) и MCP-сервер `olcli-mcp` с двадцатью с лишним инструментами; перед записью в проект он просит подтверждение в клиенте.
Для кого. Авторам статей и диссертаций на LaTeX, которые правят проект в своем редакторе и хранят его в Git, а собирают PDF на Overleaf.
Подходит, если
- Диссертацию удобнее править в Vim или VS Code, а PDF собирать на Overleaf без локального TeX Live
- Научный руководитель просит версию с отмеченными правками, и `olcli diff --latexdiff --pdf` готовит ее за одну команду
- Ночная сборка в CI должна падать, когда статья на Overleaf разошлась с репозиторием
- Агент в Claude Code или Cursor читает замечания рецензентов и отвечает на них в самом проекте
- К отправке в arXiv готовят `.bbl`, и артефакты компиляции надо скачать
Не подходит, если
- Проект лежит в обычном репозитории и собирается локально: Overleaf в цепочке лишний
- Агенту нужно только читать проект через Git без cookie сессии: для этого в каталоге есть Overleaf MCP Server
- Несколько человек правят один файл одновременно: `sync` решает конфликты по времени изменения, и побеждает более новая локальная версия
Пример запроса к агенту
Скачай проект «My Thesis» с Overleaf, покажи открытые комментарии рецензента и собери PDFОграничения
Вход идет по cookie сессии Overleaf, ее копируют из браузера. Вход по почте и паролю подходит только для собственных серверов без reCAPTCHA. Отслеживаемые правки работают лишь в проектах, чей владелец на платном тарифе Overleaf. Для `diff --latexdiff` нужен локальный `latexdiff` из TeX Live или MacTeX, а `--pdf` компилирует на стороне Overleaf, поэтому добавленные локально `.sty` и `.cls` сборку сломают. Нужен Node.js 20.18.1 или новее.
Как отключить. Выполните `olcli logout`: команда очищает глобальный конфиг и локальный `.olauth`. Затем удалите пакет командой `npm uninstall -g @aloth/olcli` или `brew uninstall olcli`, а блок `overleaf` уберите из конфигурации MCP.
Частые вопросы
Как войти в Overleaf из olcli?
Скопируйте значение cookie `overleaf_session2` в инструментах разработчика браузера и выполните `olcli auth --cookie "значение"`. Для собственного сервера задайте адрес командой `olcli config set-url`, а имя cookie, если оно другое, командой `olcli config set-cookie-name`.
Как собрать PDF без TeX Live?
`olcli pdf` компилирует проект на Overleaf и скачивает результат. Для многофайловых проектов добавьте `-r appendix.tex`, и этот файл соберется как корневой.
Удалит ли sync файлы на Overleaf?
Да, файл, которого нет локально, но он есть на Overleaf, удаляется при следующем `sync`. Отключает это флаг `--no-delete`, а `--dry-run` покажет план без изменений.
Спросит ли MCP-сервер подтверждение перед записью?
Да, `push_file`, `delete_entity`, `rename_entity` и другие записывающие инструменты показывают диалог подтверждения. Если клиент диалоги не поддерживает, сервер ничего не пишет и возвращает команду `olcli` для выполнения вручную. Выключает подтверждение переменная `OLCLI_MCP_UNCONFIRMED_WRITES=1`.
Можно ли работать с Overleaf через обычные git-команды?
Можно: после установки olcli работает remote-помощник, и `git clone overleaf::https://www.overleaf.com/project/<id>` создает рабочую копию. Дальше используются стандартные `git commit` и `git push`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер для Overleaf: агент читает проект LaTeX через Git, находит разделы и правит их с коммитом
Скилл и CLI olcli правят проекты Overleaf напрямую: точечные замены, загрузка файлов, сборка PDF и живая сессия правок.
CLI и скилл: агент публикует отчеты как HTML-документы, команда их комментирует, а каждая версия сохраняется
Локальный MCP-сервер для работы с научной литературой arXiv: чтение статей по разделам, BibTeX из метаданных, отслеживание тем
CLI Artifact Share: агент публикует HTML, Markdown и статические сайты по стабильной ссылке и обновляет ее новыми версиями
Docling — CLI для смешанного архива: PDF, документы и таблицы можно привести к общему формату для поиска и ИИ.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| olcli (эта карточка) | нет | 243 | ||
| Overleaf MCP Server | нет | API-ключ | 342 | агент читает проект Overleaf через Git и правит разделы с коммитом, а olcli работает по cookie сессии и добавляет компиляцию, комментарии и diff |
| LaTeX Document Skill | нет | 821 | пишет документ LaTeX с нуля и собирает PDF локально, а olcli синхронизирует существующие проекты Overleaf |
Коротко о README
README перечисляет возможности, способы установки через Homebrew, npm и AgentSkills, быструю схему из аутентификации, `pull`, правки, `push` и компиляции, затем таблицу команд и подробные разделы о синхронизации, `diff` и удалениях. Для MCP-сервера и git remote есть отдельные документы в `docs/`.