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 | bash

The 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#

GoalCommand
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#

Last updated 2026-11-10View as Markdown