REFERENCE
Configuration
Settings, harness profiles, the interface and where Theoria keeps its files.
Settings file#
Every setting has a default in Theoria's theoria.config.json. To change one, put just that key in ~/.theoria-cli/config.json. Objects merge into the defaults and lists replace them. A misspelt key, a wrong type or an out-of-range value stops Theoria with the key named.
{
"workflows": { "defaults": { "maxAttempts": 5 } },
"tui": { "logo": { "shearMs": 3500 } }
}Harness profiles#
A profile chooses which of Theoria's components a session loads, so you can compare Theoria with plain Pi.
theoria harness # list the profiles
theoria --harness lean # Lean checking only
theoria --harness bare # Pi as it shipsInterface#
/tui changes the footer, editor, telemetry, thinking peek and icons. At startup the Θ logo shears apart and re-assembles; tui.logo.intro (shear or sweep), holdMs, shearMs and animate control it.
Workflow prompts#
/formalize, /prove, /compress and /next-steps read their prompts from Markdown files. Autoresearch campaigns follow a methodology prompt, frozen when a campaign starts. Copy a default into .theoria/commands/<name>.md (this project) or ~/.theoria-cli/agent/commands/<name>.md (all projects) and edit it.
Where files live#
| Path | Contents |
|---|---|
~/.theoria-cli/app | Installed versions; current points at the active one |
~/.theoria-cli/agent | Pi settings, sessions and credentials, apart from a personal ~/.pi |
~/.theoria-cli/lean | Mathlib installs from /lean install (see Lean environments) |
<project>/.theoria | Project type, Lean choice, runs, claims, artifacts and benchmark results |
Uninstall#
rm -rf ~/.theoria-cli/app ~/.local/bin/theoria # the program
rm -rf ~/.theoria-cli # also settings, sessions and Lean installs