用途:通过 olcli CLI、原生 git remote 或 MCP 服务器管理 Overleaf LaTeX 项目,适合交互式同步、版本控制与 AI 智能体接入。
主要能力:pull/push/sync 双向同步(含冲突检测与删除传播)、diff 内容级对比、compile/pdf 编译与下载、output 下载 .bbl 等产物、upload/download/delete/rename 文件、comments 评论管理、project create/rename、zip 打包。
安装:brew tap aloth/tap && brew install olcli;或 npm install -g @aloth/olcli。认证:从 Overleaf 复制 overleaf_session2 后执行 olcli auth --cookie "YOUR_SESSION_COOKIE",用 olcli whoami 验证;无人值守可用 OVERLEAF_EMAIL/OVERLEAF_PASSWORD 环境变量。自托管用 olcli config set-url 与 set-cookie-name。
git remote:git clone overleaf::https://www.overleaf.com/project/<id>,之后用标准 git 工作流。MCP:运行 olcli-mcp 或 npx @aloth/olcli-mcp,提供 list_projects、pull_project、compile、download_pdf、diff_project 等工具。
限制:需有效会话凭据;.aux、.bbl、.log 等构建产物默认被过滤,可用 .olignore 调整;sync 会传播本地删除,可用 --no-delete 关闭;diff --exit-code 以 0/1/2 区分一致、有差异与运行失败。其余细节暂未提供。