| name | tmux-icons |
| description | Switch tmux status icon themes or customize individual icons for the claude-tmux-status plugin. Use when user says "change tmux icons", "switch tmux theme", "set tmux icons", or wants to customize tmux status indicators. |
| argument-hint | ["theme-name | set <state> <icon> | list | reset"] |
| allowed-tools | ["Read","Write","Bash","Glob"] |
tmux-icons: Theme and Icon Customization
Manage the icon theme for the claude-tmux-status plugin. Changes take effect immediately on the next Claude Code lifecycle event (no restart needed).
Arguments
The user invoked this with: $ARGUMENTS
Plugin Location
The plugin root is at: $CLAUDE_PLUGIN_ROOT
If $CLAUDE_PLUGIN_ROOT is empty or not set, check ~/.claude/plugins/ for the claude-tmux-status directory.
Configuration Files
- Active config:
$CLAUDE_PLUGIN_ROOT/config/active.conf — key=value file with idle, processing, attention mappings
- Theme presets:
$CLAUDE_PLUGIN_ROOT/config/themes/*.json — JSON files with name, description, and icons fields
Actions
No arguments or "list"
Show the current active config and list all available themes with their icons in a comparison table.
Theme name (e.g., "emoji", "nerd-font", "minimal")
- Read the theme JSON from
$CLAUDE_PLUGIN_ROOT/config/themes/<name>.json
- Write the icons to
$CLAUDE_PLUGIN_ROOT/config/active.conf in key=value format (one per line: idle=<icon>, processing=<icon>, attention=<icon>)
- Confirm the change and show the new active icons
"set " (e.g., "set attention !!")
- Read current
active.conf
- Replace the line for the given state with the new icon
- Write back
active.conf
- Valid states:
idle, processing, attention
"reset"
- Read the emoji theme from
$CLAUDE_PLUGIN_ROOT/config/themes/emoji.json
- Write it to
active.conf
- Confirm reset to defaults
"create "
- Ask the user for icons for each state (idle, processing, attention)
- Create a new theme JSON at
$CLAUDE_PLUGIN_ROOT/config/themes/<name>.json
- Optionally activate it
Response Format
After any change, show the resulting active configuration:
Active tmux icons:
idle: <icon>
processing: <icon>
attention: <icon>
