Skip to content
Back to search

mathcode

MathCode: A Frontier Mathematical Coding Agent

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/math-ai-org--mathcode/badge.svg)](/listings/math-ai-org--mathcode)

HTML

<a href="/listings/math-ai-org--mathcode"><img src="/api/listings/math-ai-org--mathcode/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 79 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MathCode
  2. [English](./README.md) | [中文](./README.ZH.md)
  3. MathCode is a coding assistant for the terminal and browser, with built-in Lean 4
  4. support. It can inspect proof goals, search declarations, check candidates, and
  5. verify completed proofs.
  6. [Website](https://math-ai-org.github.io/mathcode/) ·
  7. [Releases](https://github.com/math-ai-org/mathcode/releases) ·
  8. [Issues](https://github.com/math-ai-org/mathcode/issues) ·
  9. [Discord](https://discord.gg/f2AFP9W5)
  10. ![MathCode terminal demo](./Demo.png)
  11. ## What you can do
  12. - Work on code and Lean proofs in your own workspace.
  13. - Use the terminal or a local WebUI with math and diagram rendering.
  14. - Store verified theorems and explicit assumptions, and explore dependencies in Obsidian.
  15. - Add project skills, Python analysis tools, and MCP plugins.
  16. Lean is the proof authority: a proof is complete only after strict verification
  17. succeeds. Library storage and vault updates are explicit actions.
  18. ## Get started
  19. Supports **macOS Apple Silicon (arm64)** and **Linux x86_64 with glibc and AVX2**.
  20. The default backend requires the `codex` CLI and a Codex login.
  21. ```bash
  22. git clone https://github.com/math-ai-org/mathcode.git
  23. cd mathcode
  24. bash setup.sh
  25. codex auth login
  26. ./run
  27. ```
  28. Setup installs the CLI and WebUI without Lean/Mathlib by default, in both
  29. interactive terminals and scripts. `--without-lean` explicitly selects this mode.
  30. Use `bash setup.sh --with-lean` for a full installation, or add Lean later with
  31. `bash setup.sh --install-lean`. Lean support needs about 10 GiB of additional disk
  32. space. Existing Lean installations are kept.
  33. Setup installs a `mathcode` command for new shells. Use `./run` immediately, or
  34. open a new shell and run:
  35. ```bash
  36. mathcode -p "prove that the square of an even number is even"
  37. ```
  38. For the browser interface, run `./run webui` and open the local URL. To update an
  39. existing checkout, run `git pull --ff-only` and rerun setup.
  40. ## Documentation
  41. Read the [online documentation](https://math-ai-org.github.io/mathcode/docs/).
  42. | Guide | Contents |
  43. | --- | --- |
  44. | [Installation](docs/release/installation.md) | Requirements, install modes, upgrades, toolchains, troubleshooting |
  45. | [Usage](docs/release/usage.md) | CLI, WebUI, goals, sessions, schedules, diagnostics |
  46. | [Lean workflows](docs/release/lean.md) | Proof tools, theorem and axiom libraries, Obsidian, optional feedback backends |
  47. | [Configuration](docs/release/configuration.md) | Providers, model settings, skills, tools, plugins |
  48. See [release notes](RELEASE_NOTES.md) for the current release.
  49. ## Citation
  50. ```bibtex
  51. @misc{mathcode2026,
  52. title = {MathCode: A Frontier Mathematical Coding Agent},
  53. author = {Team Math-AI},
  54. journal = {math-ai-org.github.io},
  55. year = {2026},
  56. month = {April},
  57. url = "https://github.com/math-ai-org/mathcode"
  58. }
  59. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.