GET STARTED
Theoria-CLI
A Lean-native research agent for mathematics and theoretical sciences, in your terminal.
Theoria-CLI is a research agent that works with Lean and Mathlib. It formalizes statements, proves theorems, shortens proofs, searches Mathlib, keeps track of research runs and claims, and drafts papers. Lean, not the agent, decides whether a proof is correct.
Install#
Terminal
curl -fsSL https://www.theoria.sh/install/cli.sh | bashThe installer verifies the release checksum, installs into ~/.theoria-cli/app, and links ~/.local/bin/theoria. Run it again to upgrade. It requires Node.js 22.19 or later.
Theoria-CLI is in beta. macOS is fully supported. On Linux the interactive agent, Lean, the proof workflows and Mathlib search work; subagents, benchmarks, autoresearch, LeanHammer and the Telegram bot need macOS for now.
What you can do#
| Goal | Command |
|---|---|
| Choose and install Lean and Mathlib | /lean |
| Turn an idea into a Lean statement | /formalize |
| Prove a theorem, checked by Lean | /prove |
| Shorten a verified proof | /compress |
| Find next steps for a paper or topic | /next-steps |
| Attack a research objective and track its claims | /attack, /claim |
| Run unattended research campaigns | /autoresearch |
| Draft and compile a paper | /latex |
| See every command | /help |
Where to go next#
- Quickstart: from install to a first verified proof.
- Slash commands: every command, with examples.
- Autoresearch: unattended research campaigns and how their results are measured.
- Lean environments: how Lean and Mathlib are shared to save disk space.
- Configuration: settings, harness profiles and the interface.
- Changelog: what changed in each release.