Quickstart

Get your first remote LaTeX build running in minutes.

Install

Homebrew

brew install texops/tap/tx

curl

curl -fsSL https://raw.githubusercontent.com/texops/tx/main/scripts/install.sh | sh

To download the binary into the current directory without installing:

curl -fsSL https://raw.githubusercontent.com/texops/tx/main/scripts/download.sh | sh

From source (requires Go)

go install github.com/texops/tx/cmd/tx@latest

Authenticate

Registration is open — running tx login creates your account automatically.

tx login

The verification page opens in your browser with the device code already filled in — enter your email, then click the magic link sent to your inbox. The code is also shown in your terminal in case the browser does not open.

info

Credentials are stored in your system keyring and persist for 30 days.

Initialize a project

In your LaTeX project directory:

tx init

This scans for .tex files containing \documentclass, prompts you to select documents, a TeX Live version, and a compiler, then writes a .texops.yaml config file. Commit it to version control.

To skip the interactive prompts:

tx init --texlive 2025 --compiler pdflatex

Build

tx build

Files are synced to TexOps, compiled remotely, and the resulting PDF is downloaded to your working directory. Only changed files are uploaded on subsequent builds.

To build a specific document:

tx build paper

Next steps

• Configuration — customize your .texops.yaml and control which files are uploaded
• CI/CD — set up automated builds with API tokens
• CLI Reference — full list of commands and flags
• Using tx from coding agents — let Claude Code, Codex and other agents build and fix your documents