A Claude Code plugin that automatically sets your terminal tab title to an AI-generated summary of what you're working on.

Before: Every tab shows Claude Code After: Tabs show things like Fixing sandbox hook exclusions or Building React dashboard

• SessionStart hook — claims tab ownership and sets an initial [slug] new session title.
• Stop hook — after each Claude response, generates a short [slug] objective summary using Haiku and sets the tab title via OSC escape sequences. Runs in the background so it doesn't block.
• UserPromptSubmit hook — restores the saved title a moment after you submit a message, preventing Claude Code from resetting the title while it's thinking.

Run Claude Code's built-in /rename <name> and automatic Haiku titles stop overriding the tab until you /rename to a different value. Use this whenever you want a stable, hand-picked label.

• In cmux, the renamed session is shown natively, so the plugin simply gets out of the way — it clears its own tab override and lets cmux display the name.
• In other terminals, the rename value is applied to the tab title directly.

/plugin marketplace add STRML/cc-tab-titles
/plugin install cc-tab-titles@STRML

Restart Claude Code after installing.

• claude CLI in your PATH (used for Haiku summarization)
• A terminal that supports OSC 0 title sequences (Ghostty, iTerm2, Terminal.app, most others)
• python3 available

Set these environment variables to customize behavior:

Works on both macOS and Linux. Terminal tab title setting uses OSC escape sequences supported by Ghostty, iTerm2, Terminal.app, and most modern terminals.

Claude Code resets the tab title when it starts processing. The UserPromptSubmit hook handles this with a short delay, but for fully persistent titles, add the included statusline.sh to your statusLine config — it re-applies the saved title every ~300ms:

{
  "statusLine": {
    "type": "command",
    "command": "bash \"${CLAUDE_PLUGIN_ROOT}/hooks/statusline.sh\""
  }
}

If you use Claude Code's sandbox mode, add this to your excludedCommands in ~/.claude/settings.json so the nested claude -p call can reach the API:

{
  "sandbox": {
    "excludedCommands": ["bash ~/.claude/:*"]
  }
}

(This is usually already present if you use other hooks.)

MIT