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.

~/.theoria-cli/config.json
{
  "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.

Terminal
theoria harness                 # list the profiles
theoria --harness lean          # Lean checking only
theoria --harness bare          # Pi as it ships

Interface#

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

PathContents
~/.theoria-cli/appInstalled versions; current points at the active one
~/.theoria-cli/agentPi settings, sessions and credentials, apart from a personal ~/.pi
~/.theoria-cli/leanMathlib installs from /lean install (see Lean environments)
<project>/.theoriaProject type, Lean choice, runs, claims, artifacts and benchmark results

Uninstall#

Terminal
rm -rf ~/.theoria-cli/app ~/.local/bin/theoria   # the program
rm -rf ~/.theoria-cli                             # also settings, sessions and Lean installs
Last updated 2026-11-10View as Markdown