rename-tmux-window

Renames the current tmux window using a literal name, Jira ticket summary, or session topic.

1|Updated Aug 6, 2025
One-click install
npx skills add https://github.com/azaidrahman/zaid-sani-dotfiles --skill rename-tmux-window-azaidrahman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rename-tmux-window
Source: https://github.com/azaidrahman/zaid-sani-dotfiles/tree/main/dot_claude/skills/rename-tmux-window
Command: npx skills add https://github.com/azaidrahman/zaid-sani-dotfiles --skill rename-tmux-window-azaidrahman

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Long-running Claude sessions inside tmux all show generic window names, making it impossible to tell which pane holds which task. This Skill names the window after the Jira ticket or topic being worked on, so the status bar stays readable across many sessions. ## Core Features & Use Cases - Ticket-based naming: Extracts a ticket key (e.g. GTI-197) from the current git branch, fetches the Jira summary via the Atlassian MCP tool, and squeezes it into a short label like GTI-197 jira-optimizer. - Literal and topic naming: Applies a user-supplied name verbatim, or derives a 2-4 word kebab-case title from the session when no ticket exists. - Safe tmux plumbing: A bundled script targets $TMUX_PANE (Claude's own window, not the attached client's active window), preserves the leading status glyph, and sets @claude_base and @claude_autoname_done so hooks do not revert the name. - Use Case: You start work on branch feature/GTI-274-custom-domain-mapping and ask to tag the window; the window becomes ● GTI-274 domain-mapping after a quick confirmation. ## Quick Start Ask the assistant to rename this tmux window to the current Jira ticket, or say "rename this window to deploy-fix" to apply a literal name.

Frequently Asked Questions about rename-tmux-window

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

FAQPage Schema
How do I rename a tmux window to the current Jira ticket?

Ask to rename the window to the ticket; the skill reads the ticket key from the current git branch, fetches the Jira summary via the Atlassian MCP getJiraIssue tool, squeezes it into a short label, and applies a name like GTI-197 jira-optimizer.

How to set a tmux window name from a script without it reverting?

The bundled script sets the @claude_base window option alongside the rename so the notify-tmux.sh hook re-renders from the new base name, and sets @claude_autoname_done so the stop-time auto-namer does not overwrite it.

Does this work outside of tmux?

No. The skill requires $TMUX and $TMUX_PANE to be set; if the session is not running inside tmux, the script exits with code 2 and reports that it is not in tmux.

Why does tmux rename-window sometimes change the wrong window?

A bare display-message query resolves to the attached client's active window, not the pane running the command. The script targets $TMUX_PANE, which tmux sets to the process's own pane, so it always renames Claude's window.

Can I give the tmux window a custom literal name?

Yes. A literal name supplied by the user is applied verbatim after trimming, skipping the ticket lookup and the confirmation prompt used for auto-derived names.