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

```text
{
  "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.

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

## Interface

[`/tui`](https://www.theoria.sh/docs/commands.md#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`](https://www.theoria.sh/docs/commands.md#formalize), [`/prove`](https://www.theoria.sh/docs/commands.md#prove), [`/compress`](https://www.theoria.sh/docs/commands.md#compress) and [`/next-steps`](https://www.theoria.sh/docs/commands.md#next-steps) read their prompts from Markdown files. [Autoresearch](https://www.theoria.sh/docs/autoresearch.md) 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](/docs/lean-environments)) |
| `<project>/.theoria` | Project type, Lean choice, runs, claims, artifacts and benchmark results |

## Uninstall

```sh
rm -rf ~/.theoria-cli/app ~/.local/bin/theoria   # the program
rm -rf ~/.theoria-cli                             # also settings, sessions and Lean installs
```

## Related

- [Slash commands](https://www.theoria.sh/docs/commands.md): Every Theoria-CLI slash command, with its forms and examples.
- [Lean environments](https://www.theoria.sh/docs/lean-environments.md): How Theoria finds, installs and shares Lean and Mathlib, and keeps long Lean runs light on disk.
- [Autoresearch](https://www.theoria.sh/docs/autoresearch.md): Unattended, bounded research campaigns: the agent runs experiments, reads the evidence and improves a result.

Last updated 2026-11-10. Web page: https://www.theoria.sh/docs/configuration