[FEATURE] Add setting to customize or disable terminal title override
Preflight Checklist
- [x] I have searched existing requests and this feature hasn't been requested yet
- [x] 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:
- Disable the terminal title override entirely (restoring shell-managed title behavior), or
- 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_
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗