claude-math

Make math in Claude Code and Codex legible.

Terminal coding agents do not render LaTeX. In both Claude Code and OpenAI Codex CLI, a formula like $f(x) = \sum_{i=1}^n x_i$ appears as raw dollar signs and backslashes, exactly the noise you wanted formatting to remove. This project ships a single skill (math-unicode) that instructs the model to emit math as Unicode glyphs inline. Unicode-capable terminals with a suitable font render these glyphs directly. It installs as a Claude Code plugin and, via the identical SKILL.md, as a Codex skill (claude-math install --codex).

Before / after

Before:  The qualifying cohort is $Q = \{ (s,r) \in T : n_{s,r} \geq 18 \wedge p^0_{s,r} < 0.9 \}$,
         with $|Q| / |T| \approx 17.3\%$.

After:   The qualifying cohort is Q = { (s,r) ∈ T : n_{s,r} ≥ 18 ∧ p⁰_{s,r} < 0.9 },
         with |Q| / |T| ≈ 17.3 %.

Install

The quickest install is through the plugin marketplace (see below). The npm and manual paths also work.

via npm

npm install -g claude-math
claude-math install

Symlinks the package into ~/.claude/plugins/local/claude-math, registers it in installed_plugins.json, and enables it in settings.json (atomically; both files get a .claude-math.bak backup on first touch). Restart Claude Code and the skill loads.

npx claude-math install also works: the CLI auto-detects an npx-cache install path and copies rather than symlinks (since the cache directory is ephemeral). Prefer the global install if you want updates via npm update -g claude-math to propagate automatically.

Other commands:

claude-math status        # report target, validity, settings state, next-install mode
claude-math uninstall     # remove symlink/dir, deregister, disable
claude-math --help        # full flag list, env overrides

Flags: --force overrides safety checks (foreign symlinks, non-plugin directories at the target). --copy forces a real copy instead of symlink.

Manual install

git clone https://github.com/vladimirrott/claude-math \
  ~/.claude/plugins/local/claude-math

Then add "claude-math@local": true under enabledPlugins in ~/.claude/settings.json and a matching entry in ~/.claude/plugins/installed_plugins.json. The CLI does both; running it once is the easiest path.

Via Claude Code's plugin marketplace (recommended)

/plugin marketplace add vladimirrott/claude-math
/plugin install claude-math@vladimirrott

The skill normally activates for mathematical output. To load the complete rule set explicitly in Claude Code, run /math-unicode before the request.

Codex CLI

claude-math works in OpenAI Codex CLI too — the skill uses the same name + description SKILL.md frontmatter Codex reads. Two install paths:

Native Codex plugin (recommended — no npm):

codex plugin marketplace add vladimirrott/claude-math
codex plugin add claude-math@vladimirrott

Codex installs the plugin (manifest: .codex-plugin/plugin.json) and loads its math-unicode skill. Restart Codex if it does not appear; invoke with /skills or by mentioning $math-unicode. Remove with codex plugin remove claude-math@vladimirrott.

Via npm (drops just the skill file):

npm install -g claude-math
claude-math install --codex