CLI Reference¶
Global Options¶
Commands¶
theoria version¶
Display the current version.
theoria init¶
Initialize a new Theoria project in the current directory.
| Option | Description |
|---|---|
--force, -f |
Overwrite existing config file |
Creates config.theoria.yaml and detects existing .bib and .tex files.
theoria chat¶
Start an interactive dialogue session with Theoretikos.
| Option | Description |
|---|---|
--session, -s |
Resume a saved session by ID |
Slash Commands¶
| Command | Description |
|---|---|
/help, /? |
Show available commands |
/exit, /quit, /q |
Exit chat |
/clear, /reset |
Clear conversation history |
/save |
Save session to disk |
/status |
Show current dialogue state |
theoria history¶
List saved chat sessions.
| Option | Description |
|---|---|
--limit, -n |
Maximum sessions to show (default: 20) |
Auth Subcommands¶
theoria auth add¶
Add an API key for a provider.
The key will be prompted securely if not provided.
theoria auth remove¶
Remove authentication for a provider.
theoria auth list¶
List all configured providers.
theoria auth status¶
Check authentication status for a provider.
Exit Codes¶
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | General error |
| 2 | Invalid arguments |