Conversation naming #8991

pap-openai · 2026-01-09T18:42:36Z

Session renaming:

/rename my_session
/rename without arg and passing an argument in customViewPrompt
AppExitInfo shows resume hint using the session name if set instead of uuid, defaults to uuid if not set
Names are stored in CODEX_HOME/sessions.jsonl

Session resuming:

codex resume lookup for CODEX_HOME/sessions.jsonl first entry matching the name and resumes the session

JaviSoto

Looks good!!

Random suggestion I just thought of: it could be useful to give the agent a way to set the name as well via a tool call, so you can tell the agent to name the conversation as well? (you could even add something to your AGENTS.md with instructions on how you want the agent to name your sessions, or to rename them in certain cases etc)

JaviSoto · 2026-01-09T18:59:04Z

codex-rs/cli/src/main.rs

 #[derive(Debug, Parser)]
 struct ResumeCommand {
-    /// Conversation/session id (UUID). When provided, resumes this session.
+    /// Conversation/session id (UUID) or session name. UUIDs take precedence if it parses.


codex-rs/cli/src/main.rs

codex-rs/core/src/rollout/list.rs

codex-rs/core/src/codex.rs

codex-rs/core/src/util.rs

codex-rs/tui2/src/lib.rs

codex-rs/tui/src/lib.rs

JaviSoto · 2026-01-09T19:18:00Z

codex-rs/protocol/src/protocol.rs

+pub struct SessionMetaUpdatedEvent {
+    /// Name left as session_id instead of thread_id for backwards compatibility.
+    pub session_id: ThreadId,
+    #[serde(default, skip_serializing_if = "Option::is_none")]


jif-oai

I would def go to the index file

can we try to use thread instead of session as much as possible

jif-oai · 2026-01-12T14:09:06Z

codex-rs/core/src/rollout/recorder.rs

    Ok(())
 }

+async fn rewrite_session_name(


Those functions should not be needed. We should use the same mechanism as for the model used during the rollout for example

codex-rs/core/src/rollout/list.rs

codex-rs/core/src/rollout/recorder.rs

codex-rs/protocol/src/protocol.rs

… name

pap-openai · 2026-01-13T01:28:29Z

@jif-oai @JaviSoto moved to an index file instead of SessionMeta so we don't touch rollout files. We're reading a CODEX_HOME/session_index.jsonl from most recent renames to oldest. We're appending new names even if previous session had a name to avoid searching for the entry with name + rewriting file and keep write O(1).

Implemented your comments (adding tests on resume, move to thread, thread_name or thread_id naming)

pap-openai · 2026-01-17T10:26:52Z

related #4163

jif-oai · 2026-01-19T13:21:48Z

codex-rs/app-server/README.md

 - `thread/list` — page through stored rollouts; supports cursor-based pagination and optional `modelProviders` filtering.
 - `thread/loaded/list` — list the thread ids currently loaded in memory.
 - `thread/archive` — move a thread’s rollout file into the archived directory; returns `{}` on success.
+- `thread/name/set` — set or update a thread’s user-facing name; returns `{}` on success.


We should document what happens on name collisions

jif-oai · 2026-01-19T13:23:39Z

codex-rs/app-server/src/codex_message_processor.rs

+    async fn thread_set_name(&self, request_id: RequestId, params: ThreadSetNameParams) {
+        let ThreadSetNameParams { thread_id, name } = params;
+        let trimmed = name.trim();
+        if trimmed.is_empty() {


This gets validated both here and in the Op handler (codex.rs)
Maybe we should simplify and have only one validation? (the good answer being: not here :D)

jif-oai · 2026-01-19T13:32:35Z

codex-rs/core/src/rollout/session_index.rs

+    pub updated_at: String,
+}
+
+pub async fn append_thread_name(


Can you doc those functions?

jif-oai · 2026-01-19T13:34:12Z

codex-rs/core/src/state/session.rs

    pub(crate) session_configuration: SessionConfiguration,
    pub(crate) history: ContextManager,
    pub(crate) latest_rate_limits: Option<RateLimitSnapshot>,
+    pub(crate) thread_name: Option<String>,


Why not putting it in SessionConfiguration ?

jif-oai · 2026-01-19T13:34:38Z

codex-rs/core/src/state/service.rs

 use tokio_util::sync::CancellationToken;

 pub(crate) struct SessionServices {
+    pub(crate) codex_home: PathBuf,


this is not a service and it should already be easy to get if from Session

jif-oai · 2026-01-19T13:37:50Z

codex-rs/core/tests/suite/rollout_list_find.rs

+use pretty_assertions::assert_eq;
 use tempfile::TempDir;
 use uuid::Uuid;



A true integration test would be cool

jif-oai · 2026-01-19T13:38:26Z

codex-rs/docs/protocol_v1.md

    task->>-user: Event::TurnComplete
 ```

+### Session Metadata


huh? v1 doc should not be updated as you did not change the v1 protocol

jif-oai · 2026-01-19T13:39:29Z

...shots/codex_tui__status__tests__status_snapshot_cached_limits_hide_credits_without_flag.snap

 │  Approval:         on-request                                       │
 │  Sandbox:          read-only                                        │
 │  Agents.md:        <none>                                           │
+│  Thread name:      <none>                                           │


That looks like a lot of pollution? Could we make that this line is only displayed when there is a name

jif-oai · 2026-01-19T13:40:45Z

codex-rs/tui/src/chatwidget.rs

+        if self.thread_id == Some(event.thread_id) {
+            self.thread_name = event.thread_name;
+        }
+        self.request_redraw();


You should not redraw if the if above fails

jif-oai · 2026-01-19T13:41:45Z

codex-rs/tui/src/chatwidget.rs

+    fn show_rename_prompt(&mut self) {
+        let tx = self.app_event_tx.clone();
+        let view = CustomPromptView::new(
+            "Rename thread".to_string(),


Maybe "Name" and not "Rename" as it had no name before

pap-openai added 10 commits January 9, 2026 11:45

adding session naming with /rename and metadata storage in SessionMeta

0a6d2d5

fix Restore writer file handle on rename failure

bfc7a3e

changing attribute to name + support command with arg

27bbc02

fix

41e7e02

Adding session_configured_event & /status output of session name

9f6aac5

+docs

4d6e184

resume work wip

3fd2ccc

Merge branch 'resume-name' into session-naming-clean

bbab77f

safe session_name + always showing session name in /status

a0f9f68

adding appexitinfo hint codex resume <name> if set

eebd0a2

JaviSoto reviewed Jan 9, 2026

View reviewed changes

jif-oai reviewed Jan 12, 2026

View reviewed changes

pap-openai added 12 commits January 12, 2026 22:43

uses thread_name instead of session_name

32d4278

adds shell escaping for exit hint info instead of restrictive session…

aa4d062

… name

moving to index file instead of sessionmeta

3186b17

removing name from SessionMeta

8d57df0

ThreadNameUpdated instead of SessionMetaUpdated

d9c675b

moving crate up

1e568e6

reverting changes in codex-rs/core/src/rollout/list.rs

b385eb8

revert rollout changes

2da5bf2

adding test for resume command with id

e62459e

adding hint on uuid or name on exit

b8de956

naming clarity

9de9d3e

documenting public function + thread_id rename

61a0477

pap-openai requested a review from jif-oai January 13, 2026 01:31

app-server v2 + thread_id

00ec8d1

pap-openai changed the title ~~WIP: Conversation naming~~ Conversation naming Jan 13, 2026

etraut-openai added the oai PRs contributed by OpenAI employees label Jan 14, 2026

Merge main into session-naming-clean

4c32273

pap-openai added 3 commits January 15, 2026 10:41

adding thread_name in fork

c12882c

Merge branch 'main' into session-naming-clean

cb22c11

Merge branch 'main' into session-naming-clean

8456127

pap-openai and others added 4 commits January 18, 2026 21:53

Merge branch 'main' into session-naming-clean

b4c12d6

merge

9369962

Merge branch 'main' into session-naming-clean

66dac4a

Merge remote-tracking branch 'origin/main' into session-naming-clean

ebf5168

jif-oai reviewed Jan 19, 2026

View reviewed changes

Conversation naming #8991

Are you sure you want to change the base?

Conversation naming #8991

Conversation

pap-openai commented Jan 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

JaviSoto left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jif-oai left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pap-openai commented Jan 13, 2026

Uh oh!

pap-openai commented Jan 17, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

pap-openai commented Jan 9, 2026 •

edited

Loading