tab-rename

Rename terminal tabs to display worktree branch names and assigned ports.

2|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/elijahmurray/vandra-dev --skill tab-rename
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tab-rename
Source: https://github.com/elijahmurray/vandra-dev/tree/main/skills/tab-rename
Command: npx skills add https://github.com/elijahmurray/vandra-dev --skill tab-rename

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users manage their terminal environment by automatically renaming tabs to reflect the current worktree branch and associated ports, improving clarity and organization.

Core Features & Use Cases

  • Dynamic Tab Renaming: Automatically updates terminal tab titles based on worktree context.
  • Port Information Display: Includes assigned port numbers in the tab title for quick reference.
  • Use Case: When you create a new feature worktree, the terminal tab automatically changes from a generic name to something like "Feature: Login Page (3001/8001)".

Quick Start

Run the command to rename your terminal tab.

Frequently Asked Questions about tab-rename

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

FAQPage Schema
How do I rename terminal tabs to show the current worktree branch?

You can rename terminal tabs to display the current worktree branch by running a command that dynamically updates the tab title. This automatically reflects your active worktree context and assigned port numbers for better organization.

What is the best way to display assigned ports in my terminal tab title?

Displaying assigned ports in terminal tab titles is handled automatically by updating the tab name to include port numbers alongside the worktree branch. This provides quick reference for your development environment directly in the terminal interface.

Does terminal tab renaming work with all terminal applications?

Terminal tab renaming works specifically with ANSI-compatible terminals that support dynamic tab title updates. Compatibility depends on your terminal emulator's ability to process ANSI escape sequences for modifying window and tab titles.

How do I manage terminal tabs when working with multiple isolated git worktrees?

Managing terminal tabs across multiple isolated git worktrees is simplified by automatically renaming each tab to reflect its specific worktree branch and ports. This eliminates confusion when running concurrent development environments in separate terminal tabs.

Can I include both the branch name and port numbers in a terminal tab title?

Including both the branch name and port numbers in a terminal tab title is the core function of this dynamic renaming process. Tab titles are automatically formatted to show the worktree branch and assigned ports simultaneously.

Why are my terminal tabs not updating when I switch git worktree branches?

Terminal tabs may fail to update if the terminal lacks ANSI compatibility required for dynamic title updates. Ensure your terminal emulator supports ANSI escape sequences for tab renaming and that the renaming command executes upon branch switches.