wezterm-tabs

Configures WezTerm's Lua-based tab bar with icon titles and status indicators.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/nthplusio/functional-claude --skill wezterm-tabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wezterm-tabs
Source: https://github.com/nthplusio/functional-claude/tree/main/plugins/wezterm-dev/skills/wezterm-tabs
Command: npx skills add https://github.com/nthplusio/functional-claude --skill wezterm-tabs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill enables users to configure and enhance the WezTerm tab bar with icons, per-tab status indicators, and dynamic titles, reducing confusion and improving workflow visibility.

Core Features & Use Cases

  • Icon-rich tab titles: Nerd Font icons for common processes to quickly identify active tasks.
  • Dynamic directory-aware titles: shows the current leaf directory and per-tab status.
  • Config & extension points: Lua format-tab-title handler and process_icons map; references for icon usage.
  • Use Case: When working across multiple projects, the tab bar clearly shows the active folder and status.

Quick Start

Load the WezTerm tab bar configuration from this skill and restart WezTerm. For icon mappings, consult references/icons.md and adjust the config as desired.

Frequently Asked Questions about wezterm-tabs

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

FAQPage Schema
How do I customize the WezTerm tab bar with icons and status indicators?

To customize the WezTerm tab bar, you configure a Lua format-tab-title handler and a process_icons map. This setup provides icon-based titles, directory-aware names, and real-time process status for each tab.

Can I show Nerd Font icons for specific processes in WezTerm tabs?

Yes, you can display Nerd Font icons by mapping process names to icons within a Lua process_icons table. The format-tab-title handler then renders these icons in the tab bar to help you identify active tasks quickly.

How do I make WezTerm tab titles show the current directory and per-tab status?

You can make WezTerm tab titles show the current directory and status by implementing a Lua format-tab-title handler. This handler dynamically extracts the leaf directory and process status to update the tab bar text.

Does WezTerm require a Nerd Font to display tab bar icons?

Yes, WezTerm requires a Nerd Font installed in your terminal environment to render the process icons correctly. Without a Nerd Font, the icon glyphs in your tab titles will not display as intended.

What is the best way to manage WezTerm tab titles across multiple projects?

The best way to manage WezTerm tab titles across projects is using a Lua format-tab-title handler. It dynamically updates the tab bar with the active folder and per-tab status, reducing confusion when switching contexts.

Why are my WezTerm tab icons not showing up correctly?

WezTerm tab icons fail to show correctly if your terminal lacks a Nerd Font or the process_icons map is misconfigured. Ensure your font supports the required glyphs and the Lua handler maps process names properly.