[Feature Request] Add configuration option to control terminal title behavior

Resolved 💬 3 comments Opened Feb 5, 2026 by derekneely Closed Mar 6, 2026

Bug Description
Feature Request: Terminal Title Control

Current behavior:
Claude Code automatically sets the terminal window title using escape sequences (\033]0;title\007). This overrides any custom title I've set.

My use case:
I organize my workflow by grouping terminal windows by project. I have shell scripts that set custom terminal titles so when windows are
minimized, I can quickly identify which project each terminal belongs to by hovering over them. For example:

echo -ne "\033]0;${title}\007"

When Claude Code overrides my title, I lose this organization and can't quickly identify which project I'm working in.

Requested solution:
Add a setting to control terminal title behavior. Options could include:

  • "terminalTitle": false - Disable title setting entirely
  • "terminalTitlePrefix": "myprefix" - Allow a custom prefix/format
  • Respect an environment variable like CLAUDE_NO_SET_TITLE=1

Any of these would let users who manage their own terminal titles opt out of the automatic behavior while keeping the default experience for
everyone else.

Environment Info

  • Platform: darwin
  • Terminal: iTerm.app
  • Version: 2.1.31
  • Feedback ID: 957cdab6-f43d-42a8-8e17-f32602756dbe

Errors

[{"error":"Error: NON-FATAL: Lock acquisition failed for /Users/d/.local/share/claude/versions/2.1.31 (expected in multi-process scenarios)\n    at iYR (/$bunfs/root/claude:3621:2098)\n    at cbA (/$bunfs/root/claude:3621:1209)\n    at processTicksAndRejections (native:7:39)","timestamp":"2026-02-05T13:12:21.882Z"},{"error":"Error: EISDIR: illegal operation on a directory, read\n    at readFileSync (unknown)\n    at <anonymous> (/$bunfs/root/claude:12:742)\n    at d5 (/$bunfs/root/claude:11:40746)\n    at readFileSync (/$bunfs/root/claude:12:701)\n    at bPB (/$bunfs/root/claude:6124:17702)\n    at call (/$bunfs/root/claude:3564:2357)\n    at call (/$bunfs/root/claude:3560:8805)\n    at qH8 (/$bunfs/root/claude:3085:13642)\n    at processTicksAndRejections (native:7:39)","timestamp":"2026-02-05T13:23:54.567Z"}]

View original on GitHub ↗

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