mikewang817/tformula

TFormula is a terminal tool that renders LaTeX math formulas as actual images directly inside a terminal window, when using AI coding assistants like OpenAI Codex, Claude Code, Cursor Agent, Gemini CLI, and several others from the command line. Normally, when one of these tools writes out a math formula, it shows up as raw text codes like backslash-frac, which is hard to read. TFormula sits between the terminal and the agent as a proxy: it lets the agent's program run completely normally, but it also keeps a hidden copy of what is on screen, notices when LaTeX formulas appear, renders them locally using MathJax, and overlays the rendered image on top of the text using a graphics feature built into terminals like Ghostty, Kitty, and WezTerm. The original text stays available underneath for copying. Using it is a matter of installing the tool globally through npm and then running a specific launch command for whichever agent you use, such as running Codex through 'tformula codex' instead of just 'codex'. There is no plugin or extra configuration needed beyond that, the agent itself must already be installed separately. A general-purpose shell mode can also wrap any command without needing a specific alias for every agent. Beyond wrapping AI agents, TFormula includes a full-screen document reader that can open Markdown files, plain text, or images directly from the terminal, rendering headings, formatting, tables, links, and math formulas as a readable document rather than raw text, complete with keyboard navigation for scrolling, searching, and jumping between headings. Open documents are watched for changes, so saving from an editor refreshes the view automatically. Every formula that gets rendered is saved to a local history, which can be listed, and the most recently rendered formula, or an older one by its ID, can be copied to the clipboard or saved to a file in several formats, including raw LaTeX, MathML, SVG, PNG, or TIFF, with options to control color, background, scale, and padding. All rendering happens locally on the user's machine.