[FEATURE] Add setting to customize or disable terminal title override

[dev-rpr]

Preflight Checklist

• I have searched existing requests and this feature hasn't been requested yet
• This is a single feature request (not multiple features)

Problem Statement

Claude Code overrides the terminal window title during a session, which conflicts with shell-level title customization (e.g., PROMPT_COMMAND in bash/zsh). Users who rely on their terminal title to show the current working directory or repository name lose that context while using Claude Code.

Proposed Solution

Add a setting in ~/.claude/settings.json to either:

1. Disable the terminal title override entirely (restoring shell-managed title behavior), or
2. Customize the title string with support for dynamic values like $PWD, $(basename $PWD), or the git repo name

Example config:

{
"terminalTitle": "$(basename $PWD)"
}

or to disable:

{
"terminalTitle": false
}

Alternative Solutions

The status line can partially address this, but it is visible only within Claude Code's UI — not in the terminal tab/title bar or window manager.

Priority

High - Significant impact on productivity

Feature Category

CLI commands and flags

Use Case Example

Developers who work across multiple repositories in split terminals or tmux panes rely on the terminal title to identify which project each pane belongs to. Claude Code's title override removes this context.

Additional Context

No response

[peacemakerxx99]

Agreed, the task description title makes multi-session navigation impossible and statusLine is a workable but incomplete workaround.

[github-actions]

Closing for now — inactive for too long. Please open a new issue if this is still relevant.

[github-actions]

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.