Sync terminal title with thread name, and update it immediately on rename

Resolved 💬 3 comments Opened Jul 4, 2026 by elmashadmo Closed Jul 23, 2026
💡 Likely answer: A maintainer (github-actions[bot], contributor) responded on this thread — see the highlighted reply below.

What variant of Codex are you using?

Codex CLI in a terminal emulator that uses the terminal title for tab labels. (Kitty terminal).

### What feature would you like to see?

Codex should sync the terminal title with the current thread name.

Specifically:

  1. When a thread first gets a name, Codex should update the terminal title.
  2. When the thread is renamed later, Codex should immediately update the terminal title again.
  3. The visible terminal/tab title should stay aligned with the current thread name for that active session.

### Expected behavior

  • A newly named thread updates the terminal title automatically.
  • Renaming the thread updates the terminal title immediately, without restarting Codex.
  • The same thread name should be reflected consistently in session/thread UI and in the terminal title.

### Why this matters

In terminal workflows, the terminal title is often what shows up as the tab title. This helps keep multiple concurrent workflows organized and gives developers simpler visual context in their terminal tabs.

For example, in Kitty, I use the terminal title as the tab label. That makes thread naming much more useful if Codex also pushes the thread name into the terminal title and keeps it updated on rename.

Claude Code already does this, and it makes terminal tabs much easier to scan.

### Related issues

This is closely related to, but distinct from:

Those are about how the thread gets named. This request is about syncing that name to the terminal title so terminal tabs stay useful.

View original on GitHub ↗

3 Comments

github-actions[bot] contributor · 1 month ago

Potential duplicates detected. Please review them and close your issue if it is a duplicate.

  • #30836
  • #30331

Powered by Codex Action

elmashadmo · 1 month ago

Small clarification after looking into it more:

In my setup, the terminal/tab title is still basically just the cwd/project name, not the thread name. So this request is specifically about making the active thread/session name drive the terminal title, and updating it immediately when the thread is renamed.

That seems related to https://github.com/openai/codex/issues/30836, but not the same thing. https://github.com/openai/codex/issues/30836 is about terminal titles getting overwritten and not being restored. This issue is about using the thread name as the terminal title for the active session.

Also related:

https://github.com/openai/codex/issues/24289
https://github.com/openai/codex/issues/14482
https://github.com/openai/codex/issues/24060
https://github.com/openai/codex/issues/15444

elmashadmo · 1 month ago

Closing this as implemented through Codex CLI’s built-in /title configuration.

To make a terminal tab follow the active Codex thread name:

  1. Run /title in Codex CLI.
  2. Enable thread-title.
  3. Disable the other title items if you want the terminal/tab title to be only the thread name.
  4. Apply the configuration.

thread-title uses the current thread title and falls back to the thread identifier while unnamed, so it covers the Kitty tab-label workflow described here.

For history: terminal-title configuration was added in #12334, and the item now named thread-title was normalized in #18886. This is configurable rather than the default title behavior, but it provides the requested thread-name-driven terminal title without requiring a separate feature.