JasperSui/claude-code-iterm2-tab-status

21 stars · Last commit 2026-03-06

Claude Code plugin that shows live session status (⚡ running / 💤 idle / 🔴 attention) in your iTerm2 tab title — no config needed, just install and go.

PluginWorkflow & Automation Debugging Documentation Design & UI DevOps & Infra Productivity AI & Prompting Data & ML

README preview

# Claude Code iTerm2 Tab Status

[![CI](https://github.com/JasperSui/claude-code-iterm2-tab-status/actions/workflows/ci.yml/badge.svg)](https://github.com/JasperSui/claude-code-iterm2-tab-status/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**See what every Claude Code session is doing.** Each iTerm2 tab shows a status prefix. ⚡ running, 💤 idle, or 🔴 needs attention (with flashing).

![demo](assets/demo.gif)

## Installation

### Claude Code (via Plugin Marketplace)

In Claude Code, register the marketplace first:

```bash
/plugin marketplace add JasperSui/jaspersui-marketplace
```

Then install the plugin from this marketplace:

View full repository on GitHub →