terminal-title

Update terminal window titles to reflect the current Claude Code task.

1|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/ccf/claude-code-ccf-marketplace --skill terminal-title-ccf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: terminal-title
Source: https://github.com/ccf/claude-code-ccf-marketplace/tree/main/plugins/developer-essentials/skills/terminal-title
Command: npx skills add https://github.com/ccf/claude-code-ccf-marketplace --skill terminal-title-ccf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automatically sets descriptive terminal window titles based on the active Claude Code task, helping developers manage multiple sessions with clear contextual cues.

Core Features & Use Cases

  • Dynamic Titles: Updates the terminal title in response to the current high-level task.
  • Session Clarity: Keeps context visible when juggling several Claude Code sessions or modules.
  • Use Case: Start a session for "API Integration" and immediately see the task reflected in your terminal window title.

Quick Start

bash scripts/set_title.sh "API Integration"

Frequently Asked Questions about terminal-title

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically update the terminal window title for my current task?

You can automatically set the terminal title by running a bash script that emits ANSI sequences to common terminals, sanitizing the input text and optionally applying a custom prefix.

How can I manage multiple bash sessions and identify their current context quickly?

Setting descriptive terminal titles for each bash session provides clear contextual cues, helping you visually distinguish between distinct projects or modules when switching windows.

Does the terminal title update script work without external dependencies?

Yes, the title update script runs as a standalone bash script with no external dependencies, requiring only a compatible terminal emulator that supports standard ANSI escape sequences.

Can I add a custom prefix to the terminal title text?

Yes, the script supports an optional CLAUDE_TITLE_PREFIX environment variable to prepend custom text to the sanitized task name in your terminal window title.

How is the current terminal title persisted for later reference?

The script persists the current terminal title to a file at ~/.claude/terminal_title, ensuring the active session context remains available for multi-session workflows.

What is the best way to set terminal titles for multi-session automation scripts?

Using a dedicated bash script that sanitizes input and emits ANSI sequences is the best way to dynamically set terminal titles for high-level tasks in multi-session automation scripts.