/config
Configure iterm2-tab-status plugin settings (emoji prefixes, colors, display target, subtitle activity, badge, notifications)
$ npx -y skills add JasperSui/claude-code-iterm2-tab-status --agent claude-codeShips with iterm2-tab-status. Installing the plugin gets this command.
How it fires
How this command gets triggered: by you, by Claude, or both.
- Fires itselfClaude auto-loads it when your prompt matches the work.
- You can call itInvoke it directly when you want it.
- Slash command
/config
Context preview
What this command does when you run it.
Configure iterm2-tab-status plugin settings (emoji prefixes, colors, display target, subtitle activity, badge, notifications)
Command definition
config.mddescription: Configure iterm2-tab-status plugin settings (emoji prefixes, colors, display target, subtitle activity, badge, notifications)
Read the current config file at `~/.config/claude-tab-status/config.json` (create the directory if it doesn't exist). Merge with these defaults for any missing keys:
| # | Setting | Key | Default | |---|---------|-----|---------| | 1 | Running prefix | `prefix_running` | ⚡ | | 2 | Idle prefix | `prefix_idle` | 💤 | | 3 | Attention prefix | `prefix_attention` | 🔴 | | 4 | Flash color R (0-255) | `color_r` | 255 | | 5 | Flash color G (0-255) | `color_g` | 140 | | 6 | Flash color B (0-255) | `color_b` | 0 | | 7 | Flash interval (seconds) | `interval` | 0.6 | | 8 | Flash enabled | `flash_enabled` | true | | 9 | Badge enabled | `badge_enabled` | true | | 10 | Badge text | `badge` | ⚠️ Needs input | | 11 | macOS notifications | `notify` | false | | 12 | Sound file path | `sound` | (empty) | | 13 | Display target | `display_target` | title | | 14 | Subtitle activity source | `subtitle_activity_source` | off | | 15 | Signal max age (seconds) | `signal_max_age` | 1800 |
Display all settings with their current effective values in a numbered table. Then ask the user which setting(s) they want to change. After they respond, update only the specified values and write the full config to `~/.config/claude-tab-status/config.json`. The adapter will hot-reload the changes within ~1 second.
Validation rules:
- `color_r`, `color_g`, `color_b`: integers 0-255
- `interval`: positive float
- `flash_enabled`, `badge_enabled`, `notify`: boolean
- `display_target`: one of `title`, `subtitle`, or `both`
- `subtitle_activity_source`: one of `off` or `prompt`; `prompt` appends a compact sanitized snippet to the subtitle and is opt-in because prompt text may be sensitive
- `sound`: valid file path or empty string
- `signal_max_age`: integer seconds; expire signals not refreshed within this window (guards against tabs stuck on a stale status); `0` or negative disables age-based expiry
Read more
description: Configure iterm2-tab-status plugin settings (emoji prefixes, colors, display target, subtitle activity, badge, notifications)
Read the current config file at `~/.config/claude-tab-status/config.json` (create the directory if it doesn't exist). Merge with these defaults for any missing keys:
| # | Setting | Key | Default | |---|---------|-----|---------| | 1 | Running prefix | `prefix_running` | ⚡ | | 2 | Idle prefix | `prefix_idle` | 💤 | | 3 | Attention prefix | `prefix_attention` | 🔴 | | 4 | Flash color R (0-255) | `color_r` | 255 | | 5 | Flash color G (0-255) | `color_g` | 140 | | 6 | Flash color B (0-255) | `color_b` | 0 | | 7 | Flash interval (seconds) | `interval` | 0.6 | | 8 | Flash enabled | `flash_enabled` | true | | 9 | Badge enabled | `badge_enabled` | true | | 10 | Badge text | `badge` | ⚠️ Needs input | | 11 | macOS notifications | `notify` | false | | 12 | Sound file path | `sound` | (empty) | | 13 | Display target | `display_target` | title | | 14 | Subtitle activity source | `subtitle_activity_source` | off | | 15 | Signal max age (seconds) | `signal_max_age` | 1800 |
Display all settings with their current effective values in a numbered table. Then ask the user which setting(s) they want to change. After they respond, update only the specified values and write the full config to `~/.config/claude-tab-status/config.json`. The adapter will hot-reload the changes within ~1 second.
Validation rules:
- `color_r`, `color_g`, `color_b`: integers 0-255
- `interval`: positive float
- `flash_enabled`, `badge_enabled`, `notify`: boolean
- `display_target`: one of `title`, `subtitle`, or `both`
- `subtitle_activity_source`: one of `off` or `prompt`; `prompt` appends a compact sanitized snippet to the subtitle and is opt-in because prompt text may be sensitive
- `sound`: valid file path or empty string
- `signal_max_age`: integer seconds; expire signals not refreshed within this window (guards against tabs stuck on a stale status); `0` or negative disables age-based expiry
See what every Claude Code session is doing. Each iTerm2 tab shows a status prefix. ⚡ running, 💤 idle, or 🔴 needs attention (with flashing).