Releases: zeyuyang42/ByeTex
Release list
ByeTex v0.7.3 — TikZ placeholders, convert purity, honest install paths
First release since v0.6.29. Everything from 0.6.30 → 0.7.3 was previously unreleased — including several fixes that broke whole documents.
Fixed since v0.6.29
Silent data loss
- TikZ pictures were dropped with no placeholder and no warning (
warnings.jsoncame back[]). They now leave a marked placeholder and atikzwarning that routes to thebyetex-tikz-to-typstskill. - Multi-file projects lost most of their body. The pre-parse guard for
_in\label/\refkeys ran only on the entry file, so every\inputed file still hit the tree-sitter parse cascade — the exact layout--projectmode exists for. - Converting a file read every other
.texin its directory, injecting unrelated projects' label keys as hidden anchors and making output depend on neighbouring files.
Crashes and uncompilable output
- A non-ASCII
\verbdelimiter (\verb§…§) panicked the whole conversion — exit 1, no output. - A repeated
\bibliography{}emitted two#bibliography(…)calls, which Typst rejects outright: the generated project could not compile at all. - A
.bibregistered twice was materialised empty, breaking every citation.
Fidelity
- Table rules are drawn where the LaTeX declares them. Mid-table
\midrulegroup separators used to collapse into one — one corpus paper declares 91 rules and got 45. \cmidruleno longer draws a spurious full-width line through the header, and\cmidrule{a-b}without a trim prefix now produces a rule at all.- Symlinked directories, entry-file detection in repos with several
\documentclassfiles,\multirowplaceholder rows, and more — seeCHANGELOG.md.
Archives
Each archive bundles the byetex binary and the 14 repair skills (skills/<name>/SKILL.md) — the previous release shipped only the binary. Verify against SHA256SUMS.
macOS arm64/x86_64 · Linux musl arm64/x86_64 · Windows x86_64 (gnu)
curl -fsSL https://raw.githubusercontent.com/zeyuyang42/ByeTex/main/install.sh | sh
cargo install byetexandbrew installare not available — neither was ever published, and both have been removed from the docs. Build from source withcargo install --git https://github.com/zeyuyang42/ByeTex byetex.
ByeTex v0.6.29 — beamer presentation fidelity
A beamer-fidelity release (everything since v0.6.6), driven by a vision-based visual grader scoring each converted deck against its LaTeX truth render. The metropolis demo deck went from 11 pages (raw-LaTeX leaks, orange theme) to 15 pages — matching the truth exactly — with the deck's real teal accent.
Highlights
- Beamer slide structure — metropolis
\sections now render their section-divider slides,\begin{frame}[standout]becomes a touying#focus-slide(dark focus slide), and a titleless\begin{frame}is its own slide instead of merging onto the previous one. - Beamer theme colour — a deck's accent set via
\setbeamercolor{alerted text}(orstructure) now drives touying'sprimary(progress bar / section rule /\alert), resolved even through an\inputed colour file. - Raw-LaTeX leaks fixed —
\usetheme[opts]{name},\institute[short]{…}+\inst{N}markers, the\color{name}switch form, and nested\texttt{\textit{…}}no longer leak source text onto slides;\begin{verbatim}renders as a#rawblock instead of being dropped; the beamer\appendixheading no longer shows a degenerate-.1. - Corpus — four presentation decks added (three metropolis + one Madrid/default theme), each truth-rendered, measured, and gated in the fidelity baseline.
Eleven visual-grader findings fixed in total; corpus fidelity 0.827 → 0.834.
Install
Download the asset for your platform below, extract, and put byetex on your PATH. Verify against SHA256SUMS.
See the CHANGELOG for the full per-version detail (0.6.7–0.6.29).
🤖 Generated with Claude Code
ByeTex v0.6.6 — touying beamer + thesis fidelity
A fidelity-driven release (everything since v0.5.20), with every fix grounded against a reproducible truth render of the source LaTeX.
Highlights
- Beamer → real Typst
touyingpresentations (metropolis theme): dark header bar + footer/slide-number chrome,\sectiondividers gated on\AtBeginSection, detected theme colors, and incremental overlay builds (\pause/\item<n->/\only<n>). - Thesis/report fidelity — generic cover page for
\coverimage/\makecover, and chapter-per-page density (each\chapterstarts a fresh page; tudelft thesis 6 → 10 pages). - Paper fidelity — ACL title size + reworked ACL author block (institutions kept,
\thanks/\footnotemarkno longer leaking). - Math — a comma in
\overset/\stackrelover-text no longer breaks Typstattach(closed an acceptance blind spot). - Truth-render pipeline —
scripts/setup_truth_deps.shprovisions a version-matched biber + fonts; corpus ingestion now gates on a successful truth render.
See CHANGELOG.md for the full list.
Install
Download the archive for your platform below, extract, and put byetex on your PATH. Verify with shasum -a 256 -c SHA256SUMS.
Targets: macOS (arm64/x86_64), Linux musl (arm64/x86_64, static), Windows (x86_64).
ByeTex v0.5.20 — beamer + book/thesis support
First release since v0.3.0 — bundles all the 0.4.x/0.5.x work. Built locally (5 targets).
Highlights
- Beamer presentation support — a LaTeX beamer deck → Typst slides: frames (one page each),
columns→grid, blocks→titled#block, the title slide, overlays collapsed, per-deck theme colors (detected, not hard-coded), 4:3 / 16:9 geometry. - Book/report/thesis support — chapter/section heading hierarchy,
\tableofcontents→#outline,\frontmatter/\mainmatterpage numbering,longtable→#table,\subtitle,\appendixlettering, isolated\begin{titlepage}. - Agent surface —
diagnose <.typ>leaked-LaTeX scan, awarnings.jsonsidecar fromdiagnose --project, and newbyetex-beamer/byetex-bookskills (15 skills total). - Many converter fixes — author-block leaks, counter/label underscore leaks, inner-math, and more.
See CHANGELOG.md for the full per-version detail.
Install
Download the archive for your platform below, extract, and put byetex on your PATH. Verify with shasum -a 256 -c SHA256SUMS.
ByeTex v0.3.0 — Agent in the loop
ByeTex v0.3.0 — Agent in the loop
ByeTex converts LaTeX to Typst for AI agents. v0.3.0 is the "agent in the loop" release:
the MCP server grows from 7 to 11 tools, the visual-fidelity loop becomes one command,
and ByeTex now installs as a Claude Code plugin (plus an install script, crates.io, and Homebrew).
Highlights
11 MCP tools (was 7) — with full CLI parity
validate— Stage-0 oracle: compile the input LaTeX with tectonic to tell a broken
source from a ByeTex bug, before you start repairing.compile/render—typst compileto PDF / per-page PNGs with structured
errors ({ok, errors, …}) — no more shelling out totypstand scraping stderr.explain— a per-node LaTeX→Typst map: "why did this LaTeX emit this Typst?"convert_fragmentnow honours itscontext_hint(math hints wrap the fragment so bare
math like\frac{1}{2}converts as math, not an unknown text command).
One-command visual-fidelity loop
byetex review <paper>renders the converted Typst to per-page PNGs and rasterises the
original LaTeX render alongside, emitting agrading_packet.jsonfor the
byetex-visual-gradingskill.- A two-layer fidelity regression gate: deterministic structural metrics
(scripts/fidelity_gate.sh) + a vision-graded findings diff (scripts/findings_diff.py).
Reproducible snippet primitives
byetex convert -c '\frac12'(or-for stdin) — convert a snippet to stdout, no files.byetex explain -c '…'— the source map for any fragment.
Installs four ways
# Claude Code plugin (skills + MCP server)
claude plugin marketplace add zeyuyang42/ByeTex && claude plugin install byetex@byetex
# Prebuilt binary
curl -fsSL https://raw.githubusercontent.com/zeyuyang42/ByeTex/main/install.sh | sh
# crates.io
cargo install byetex --features mcp
# Homebrew
brew install zeyuyang42/byetex/byetexStatus
- Compile-rate (the gate): 59/59 ByeTex-attributable arXiv papers compile (100%).
- Visual fidelity (the driver): 0.821 corpus composite score.
- CI runs
cargo fmt --check+cargo clippy -D warnings+cargo test --workspace(904 tests).
Notes
- The CLI crate is now published as
byetex(socargo install byetexworks); the binary
name and thecrates/byetex-clidirectory are unchanged. - No conversion-logic changes in this release — it is entirely new agent tooling, packaging,
and docs, so the 59/59 compile-rate is preserved. - Full changelog: CHANGELOG.md.
Binaries in this release
Prebuilt, statically-linked binaries (built locally), verifiable against SHA256SUMS:
| Platform | Asset |
|---|---|
| macOS arm64 | byetex-v0.3.0-aarch64-apple-darwin.tar.gz |
| macOS x86_64 | byetex-v0.3.0-x86_64-apple-darwin.tar.gz |
| Linux x86_64 (musl) | byetex-v0.3.0-x86_64-unknown-linux-musl.tar.gz |
| Linux arm64 (musl) | byetex-v0.3.0-aarch64-unknown-linux-musl.tar.gz |
| Windows x86_64 | byetex-v0.3.0-x86_64-pc-windows-gnu.zip |
The Windows build is the GNU ABI (x86_64-pc-windows-gnu, cross-built via Zig with a static
CRT — imports only Windows system DLLs, no MinGW runtime needed), not MSVC. It runs on Windows
10/11; for a native MSVC build use cargo install byetex or build from source on Windows.
Full Changelog: v0.2.0...v0.3.0