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

Resolved 💬 2 comments Opened Apr 7, 2026 by dev-rpr Closed May 26, 2026

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:

  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_

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗