terminal-title

Update terminal window titles with emoji, project, and topic.

90|6|Updated Oct 15, 2025
One-click install
npx skills add https://github.com/2389-research/claude-plugins --skill terminal-title-2389-research
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: terminal-title
Source: https://github.com/2389-research/claude-plugins/tree/main/terminal-title/skills
Command: npx skills add https://github.com/2389-research/claude-plugins --skill terminal-title-2389-research

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Updates the terminal window title to reflect the current context by automatically applying emoji, project name, and topic at session start and during topic changes.

Core Features & Use Cases

  • Automatically updates terminal titles on session start and topic shifts to keep you oriented.
  • Supports cross-platform environments (Unix and Windows) via dedicated scripts.
  • Reads emoji from TERMINAL_TITLE_EMOJI and derives a human-friendly project name.

Quick Start

Use the terminal-title skill to update the terminal title manually or verify automatic updates with the following: For Unix/Linux/macOS: bash <skill-base-dir>/scripts/set_title.sh "Project Name" "Topic" For Windows: pwsh -NoProfile -ExecutionPolicy Bypass -File <skill-base-dir>/scripts/set_title.ps1 "Project Name" "Topic"

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 terminal window titles to show current project context?

You can automatically update terminal window titles by triggering updates at session start and topic changes. This sets the title to display context using emoji, project name, and topic via dedicated scripts.

Does updating terminal titles work on both Windows and Unix environments?

Yes, updating terminal titles works cross-platform by providing dedicated scripts. It includes a shell script for Unix/Linux/macOS and a PowerShell script for Windows to emit the required sequences.

How do I set a custom emoji in my terminal title bar?

To set a custom emoji in your terminal title, configure the TERMINAL_TITLE_EMOJI environment variable. The scripts read this variable and prepend the specified emoji to the project and topic context.

What is the best way to keep terminal window titles in sync with active topics?

The best way to keep terminal titles in sync is using automated hooks that trigger on topic changes and session starts. This ensures the window title dynamically reflects your current context without manual updates.

How do I manually test terminal title updates using shell scripts?

You can manually test updates by running the provided scripts with project and topic arguments. Use the shell script for Unix or PowerShell script for Windows to emit the title escape sequences and verify the change.