bbtex
LaTeX package for BBEdit
I write my papers in BBEdit, and bbtex is the set of LaTeX tools I wanted there: press ⌘K to build, click an error to land on its line, jump between the source and the PDF in Skim, and check an equation without recompiling the whole paper. It lives in BBEdit's Scripts menu and uses BBEdit's own results browser and preview windows, so it should feel like part of the editor.
New here? Start with Getting started.
What it does
- Builds. ⌘K saves the project, runs latexmk (pdfLaTeX, XeLaTeX, LuaLaTeX) or Tectonic, and lists errors and warnings in the results browser. See compiling projects.
- SyncTeX with Skim. The PDF follows the cursor without stealing focus; ⌘-click in Skim goes back to the source.
- Equation previews. Selected math renders with the document's own preamble in a small window, on demand, on save, or following the selection. See equation previews.
- Project outline. Search sections, equations, captions and labels across included files and jump there. See project outline.
- Citations and references. Pick keys by author, title, year or label context. See the pickers.
- Environment editing. Change, toggle or wrap environments in one undo; TexLab supplies completion. See writing and editing.
A quick tour
Press ⌘K and Skim opens the PDF where the cursor is:

A broken build lists its errors in BBEdit, one click from the line:

Select an equation to see it rendered with the document's preamble:

Install
Download bbtex-macos-arm64.bbpackage.zip from the releases page, unzip it, double-click bbtex.bbpackage, and run Scripts → LaTeX — Doctor. You need MacTeX (or TinyTeX) and Skim; Getting started covers the rest, including a source install.
Totally vibe coded
Every line of bbtex, its tests and these pages was written by an AI coding agent (Claude Code), with me describing what I wanted and trying it in BBEdit. It is tested fairly hard (unit, cram, real-engine and native BBEdit checks), but keep your papers in version control and open an issue when something looks off. About bbtex has the longer story.