Session Titles

A sub-spec of the agent console. A session's title is read from its transcript: a custom title if one was set, else Claude Code's summary, else the first prompt. The sessions tab and the heads-up display both draw it, and neither can change it. Several sessions in one repository are then told apart by whatever their first prompt happened to say. The Code tab renames a session by clicking "the session title in the toolbar at the top of the active session".

What it changes

• Clicking the title renames the session, in the heads-up display for the open session and on a session's row in the sessions tab for any other. The title becomes a text field in place. Enter saves and Escape keeps the old title. An empty title saves nothing.
• The title is the transcript's. A new RenameSessionCommand has the host call the SDK's renameSession, which appends a custom-title entry to the session's own transcript file. getSessionTitle already prefers customTitle, so the sessions list reads the new title back with no change, and the title travels with the transcript rather than living in the page.
• An open session's title updates at once. The host also sets the open session's in-memory title and refreshes the sessions list, so every connected page redraws it.
• A session with no transcript yet, opened but not prompted, is renamed in memory only. Its first prompt starts the transcript, and the host writes the pending title to it then.

What is deliberately not in it

• No tags or colours. The SDK's tagSession exists, but a title is the one thing both reference surfaces let a person set. Grouping sessions is deferred.

Key files

Sources

• Claude Code desktop — work in parallel with sessions — "To rename a session, click the session title in the toolbar at the top of the active session."
• Claude Agent SDK — TypeScript reference — renameSession, which appends a custom-title entry to the session's transcript.