lattice README

项目的 README,来自 github.com/leo1oel/lattice。合并为一个 markdown 文件:README.md。

Lattice

Lattice

A local-first LaTeX workspace for macOS, with your papers, your co-authors and an AI agent in the same window

Download Try it in your browser Website Watch the film Release notes Developer docs Issues 中文

Release CI License

Lattice with a LaTeX paper open: the Project tree and Papers library on the left, the source in the middle, the compiled PDF on the right

Why Lattice

A paper is more than a .tex file: it is the PDF you check, the papers you cite, the comments your co-authors leave and, now, an agent that edits with you. Lattice keeps all of them in one native Mac window. Your project stays an ordinary folder on disk, so it works offline, opens in any other editor and fits under Git; Overleaf is a sync target, not the place your paper lives.

Write

Source and PDF side by side (or the PDF in a window of its own, for a second screen), with completion and diagnostics as you type, SyncTeX jumps both ways and one-click builds with your own TeX Live. Switch a .tex tab from Source to Visual to read and edit it with its headings, emphasis, equations, lists and figures drawn in place, in the same editor. An outline rail follows your sections, \cite keys show their reference on hover, and six highlighters with meanings mark what still needs work. Start from a NeurIPS, ICML, ICLR, ACL, CVPR or AAAI template or one of two thesis classes, and Export for arXiv writes one ZIP that builds on its own. Dock any panel anywhere, keep Writing, Reading and Bibliography layouts, or save your own workspaces.

Revise

Annotations panel in round 2 with three proposals to review; the agent's rewrite of the abstract's opening line is open inline in main.tex with Accept, Reject and Try again

Select text to Proofread or Polish it in place, with a reason for each edit. Annotate the source or the PDF, then revise from your annotations in rounds: the agent proposes an edit for each one and you accept or reject it in place. Annotations and Overleaf comments also line up in a column beside the PDF, each level with its mark on the page, where you read, reply to and resolve them. Export review PDF writes the annotations you tick into a copy of the compiled PDF as standard PDF comments, so collaborators can read them in Preview, Acrobat or Zotero.

Bring your own agent

The Agent panel runs Claude Code or Codex, or another agent CLI on your Mac such as Cursor, OpenCode or Droid, signed in as you. Or connect your own OpenAI- or Anthropic-compatible API in Settings › Agent › Model endpoint: an address, a key (kept in your Keychain) and model names, which the agent runs through Pi with no command-line tool to install. Lattice comes with no model and no AI subscription of its own. The agent reads your project and papers, fixes build errors and edits files; every change shows as a diff you can review or undo. It can also use the MCP servers you add to that CLI, such as Zotero or Heptabase: see Zotero, Heptabase and the Agent panel.

Research

Papers library with nine papers on the left, Mamba: Linear-Time Sequence Modeling with Selective State Spaces open as a readable page in the middle, and the compiled draft on the right

Paper shown: Albert Gu and Tri Dao, “Mamba: Linear-Time Sequence Modeling with Selective State Spaces”, arXiv:2312.00752, CC BY 4.0.

Add papers by arXiv ID, DOI, title, link or BibTeX, or straight from your Zotero library, and read each as a blog, the paper or the PDF beside your draft. Cite in one step, with the reference on hover. The library sorts, filters and groups by what you cite; Check references audits your bibliography against Crossref and shows each finding in a keyboard queue.

Collaborate with Overleaf

main.tex with Overleaf comment highlights and a co-author's live cursor, beside the Overleaf panel's Comments tab with three threads from demo co-authors, and Suggestions and Chat tabs

Two-way Overleaf sync with live presence, chat, comments and tracked changes. Your co-authors stay on Overleaf and their edits arrive as they type; nobody else needs Lattice. Comments read as conversations with one colour per person, and margin review sets comments and suggestions beside their lines.

Every format

The attention-map.tldr whiteboard open in the editor beside notes.md shown as a formatted Markdown document; the Project tree lists the same project's HTML page, spreadsheet and slides

Markdown notes edited in blocks, tldraw whiteboards, interactive HTML pages and spreadsheets with formulas live in the same project as the paper. Slides are React decks powered by Open Slide: edit them, comment on them, let the agent revise them, and present from Lattice. Import files… brings in anything else from your Mac.

History

History panel: the agent's rewrite of the abstract expanded to its diff with Restore this file, followed by a citation, your own edit and co-authors' saved versions, with the compiled PDF on the right

One timeline for saved versions, every edit from you or the agent, and Overleaf's history. Open any entry to see its diff and restore a file, or Compare… any two versions and export the PDF with the changes marked (via latexdiff from your TeX Live). Track changes turns on review mode: your edits since then are marked in the source as you type, the PDF can show them marked too, and you accept or reject each change, or all at once, without an Overleaf plan. The Git panel shows changes and pull requests when the project is a repository.

Install

Lattice runs on Macs with macOS 14 or later, Apple silicon or Intel, and builds with your own MacTeX or TeX Live. No TeX yet? Lattice offers to install BasicTeX for you: it is the first step of the Get started checklist, and a build that finds no TeX offers it too.

  1. Download the .dmg from the latest release and drag Lattice into Applications. On a Mac with an Intel processor, download the one ending in _x64.dmg (Apple menu → About This Mac shows Chip on Apple silicon and Processor on Intel). Or install it with Homebrew: brew install --cask lattice. The app updates itself, so Homebrew leaves upgrades to it.
  2. Open a folder, start from a template, or connect an Overleaf project. Guided tutorial in the project menu opens a sample paper beside Get started, a six-step checklist from building the PDF to letting the Agent revise a paragraph.

Official builds are signed, notarized by Apple, and update themselves.

Linux (experimental). Releases that pass their Linux checks also carry an x86_64 .AppImage, for Ubuntu 22.04 or later, Fedora 45 and similar distributions. Make it executable (chmod +x Lattice_*.AppImage) and run it; it builds with the TeX Live from your distribution's packages. On Linux, Lattice checks for new releases and links to GitHub Releases, but does not update itself; download each new release yourself. The built-in Agent is not available yet.

Windows (experimental). Releases that pass their Windows checks also carry an unsigned x64 windows-x64-experimental-setup.exe, with a SHA-256 checksum and setup instructions. SmartScreen may warn about the unknown publisher. The Agent and automatic updates are unavailable; Lattice can install TeX Live for you from its setup dialog, or you can install it yourself. See the Windows guide for requirements and limitations.

Contributing

To build from source, see CONTRIBUTING.md and the architecture docs. Bug reports and pull requests are welcome; please open an issue before a large refactor.

Acknowledgements

Lattice stands on many open-source projects. The major ones:

License

Lattice is licensed under the Apache License 2.0 (see also NOTICE), with the MIT-licensed Synara agent runtime by T3 Tools Inc. and Emanuele Di Pietro. Releases up to and including 0.1.341 were GPL-3.0-or-later and remain available under those terms. See third-party notices for component licenses and Synara integration notes for the runtime details.

The GPUI preview app in gpui/ is a separate program under GPL-3.0-or-later (gpui/LICENSE), because it links Zed's GPL-3.0-or-later editor crates; a few of its parts are Apache-2.0, as its README lists. Everything outside gpui/ stays Apache-2.0.

Two components carry their own terms:

lattice (leo1oel/lattice)

正在搜索数据库…

这是什么?一款面向 macOS 的本地优先 LaTeX 写作应用。它将你的 .tex 项目、实时 PDF、引用的论文、批注、Overleaf 同步和 AI 智能体整合在一个原生窗口中,而你的项目始终是磁盘上的普通文件夹。
它只是 LaTeX 编辑器,还是有更多功能?功能不止于编辑器。除了源码和 PDF 窗格,它还支持 Markdown 笔记、tldraw 白板、交互式 HTML 页面、电子表格和基于 React 的幻灯片,所有这些都与论文位于同一个项目中。
怎样才能让它运行起来?从最新版本中下载 .dmg 文件,将 Lattice 拖入“应用程序”文件夹,或使用 Homebrew 运行 'brew install --cask lattice' 安装。然后打开一个文件夹、从模板开始,或连接 Overleaf 项目。
我需要先安装 TeX 吗?Lattice 使用你自己的 MacTeX 或 TeX Live 进行编译。如果未找到,它会提供为你安装 BasicTeX 的选项。它可在 macOS 14 或更高版本上运行,支持 Apple 芯片和 Intel 芯片。
Linux 和 Windows 版本能直接使用吗?还不完全可以。两者都标注为实验性版本。内置的智能体目前在这些平台上尚不可用,Linux AppImage 不会自动更新,而 Windows 安装程序未签名,因此 SmartScreen 可能会发出警告。
它能与 Overleaf 和我的合作作者协作吗?可以,通过双向 Overleaf 同步,并支持实时在线状态、评论和修订追踪。合作作者可以继续使用 Overleaf,他们的编辑会随输入实时同步,因此无需使用 Lattice。
我能否在智能体的修改生效前进行审阅?可以。每项修改都会以差异对比的形式显示,你可以审阅或撤销。对于批注,你可以在原处接受或拒绝每一项建议的编辑。
我能与不使用 Lattice 的人分享我的标注吗?可以。“导出审阅 PDF”会将你勾选的批注以标准 PDF 注释的形式写入已编译 PDF 的副本中,因此合作者可以在“预览”、Acrobat 或 Zotero 中阅读。
如何将论文添加到我的文献库?可以通过 arXiv ID、DOI、标题、链接或 BibTeX 添加论文,也可以直接从你的 Zotero 文献库中添加。之后只需一步即可引用,并且鼠标悬停时会显示参考文献信息。
作者
leo1oel
大小
166.4 MB
星标
539
时长
4个月
提交 · 90 天