docs(core): document session title generation

Document the new `[session_titles]` settings and clarify the thread-title generation internals with focused rustdoc comments.

This explains how generated names interact with `/rename`, when the background request is allowed to run, and why generated title values are sanitized before being persisted.
This commit is contained in:
Felipe Coury
2026-04-09 22:05:38 -03:00
parent d35a533e0f
commit eb367e3030
3 changed files with 44 additions and 0 deletions

View File

@@ -72,6 +72,24 @@ back to these environment variables.
Codex stores "do not show again" flags for some UI prompts under the `[notice]` table.
## Session titles
Interactive sessions generate a short default thread name after the first user prompt. The generated name uses the same storage and update event as `/rename`, and `/rename` still wins if the user names the thread before the background title request commits.
Disable default title generation with:
```toml
[session_titles]
enabled = false
```
Select the auxiliary model used for generated titles with:
```toml
[session_titles]
model = "gpt-5.4-mini"
```
## Plan mode defaults
`plan_mode_reasoning_effort` lets you set a Plan-mode-specific default reasoning