[FEATURE] Option to disable Claude Code setting the tmux pane title

Resolved 💬 3 comments Opened Mar 5, 2026 by JakeSummers Closed Mar 9, 2026

Problem

Claude Code continuously sets the tmux pane title via escape sequences (to show a spinner animation). This cannot be overridden by the user — any tmux select-pane -T "custom title" is immediately reverted.

This is problematic because:

  1. Users who want to label their panes with meaningful names (e.g., session summaries) cannot do so on the pane running Claude Code
  2. Users who prefer clean pane borders with no titles are forced to see the Claude Code spinner
  3. It conflicts with tmux pane-border-status configurations — users who didn't previously have pane-border-status enabled now see titles they didn't ask for if they enable it

Proposed solution

Add a configuration option (e.g., in settings.json) to disable Claude Code from setting the tmux pane title. Something like:

{
  "terminal": {
    "setTmuxPaneTitle": false
  }
}

When disabled, Claude Code should not emit pane title escape sequences, leaving the pane title under the user's control.

Environment

  • macOS (iTerm2 + tmux)
  • Claude Code CLI

View original on GitHub ↗

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