cd /news/developer-tools/your-terminal-can-t-render-latex-her… · home topics developer-tools article
[ARTICLE · art-64288] src=dev.to ↗ pub= topic=developer-tools verified=true sentiment=↑ positive

Your terminal can't render LaTeX. Here's a 10-second fix for Claude Code and Codex

Developer Vladimir Rott created claude-math, a SKILL.md file that teaches Claude Code and Codex to output Unicode math symbols instead of raw LaTeX in terminal environments. The tool maps LaTeX commands to Unicode characters like ∑, ∫, and √, making equations readable without a graphics backend.

read2 min views70 publishedJul 18, 2026

Ask Claude Code or Codex to explain some math and your terminal shows this:

H(p) = $-\sum_{i} p_{i} \log p_{i}$ That is LaTeX. A browser renders it into a clean equation. A terminal renders it into dollar-sign noise, because a TUI has no math engine to run. The more math-heavy your work (ML, statistics, optimization, proofs), the worse the output gets exactly where you need it clear.

That is the hard, unsolved path: it needs a graphics backend like Kitty or SIXEL, plus a fallback for SSH and tmux. There is a cheaper move. The model does not have to output LaTeX at all.

Unicode already has most inline math: ∑, ∫, √, ≤, ≥, ∈, α, β, σ, x², pᵢ, set notation, even small matrices. A terminal renders all of it, because it is just text. So you teach the model to skip LaTeX and emit the Unicode directly:

before: H(p) = $-\sum_{i} p_{i} \log p_{i}$

after: H(p) = − ∑ᵢ pᵢ · log pᵢ

[ claude-math](https://github.com/vladimirrott/claude-math) does exactly that. It has no runtime; it is a

SKILL.md

the agent loads, with a glyph cheatsheet so the mapping stays consistent. It is copy- and search-safe (plain Unicode, not the "mathematical alphanumeric" styling codepoints that break find-in-page), and the same file works in Claude Code and Codex.npx claude-math install # Claude Code

npx claude-math install --codex # Codex CLI Restart your agent and math comes back as text you can read.

One caveat, stated plainly: this is a workaround, not native rendering. A dense derivation is still clearer as typeset math, and on a GUI surface that already renders LaTeX you want the LaTeX, not Unicode. claude-math is deliberately a terminal tool. Buh that fills an agent's answers, it is an immediate improvement.

Repo: [https://github.com/vladimirrott/claude-math](https://github.com/vladimirrott/claude-math)

If the Unicode mapping ever looks wrong, that is exactly the kind of issue I want to hear about.
── more in #developer-tools 4 stories · sorted by recency
── more on @claude code 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
Live at https://your-agent.zahid.host
Get free account → Pricing
from €0/mo · no card required
LIVE [news/your-terminal-can-t-…] indexed:0 read:2min 2026-07-18 ·