JasperSui

JasperSui / claude-code-iterm2-tab-status

Public

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

claude-code claude-code-plugin cli-tools developer-tools iterm2
11
1
100% credibility
Found Mar 12, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

A plugin for Claude Code that adds visual status indicators to iTerm2 tabs, showing if sessions are running, idle, or awaiting user input.

How It Works

1
🔍 Discover the helper

While using Claude Code in multiple terminal tabs, you find this tool that shows each tab's status at a glance.

2
📥 Install easily

Inside Claude Code, you add a marketplace and install the tab status plugin with simple commands.

3
🚀 Automatic setup

The tool quietly prepares everything in your terminal app on the first use, creating what it needs.

4
🔄 Quick restart

Restart your terminal or toggle the script to activate the changes.

5
✨ See statuses live

As you run Claude Code sessions, tabs light up with lightning for busy, sleep for done, or flashing red for needs attention.

6
⚙️ Tweak preferences

Use a command to adjust colors, sounds, or messages to fit your style.

🎉 Work smarter

Now you glance at tabs to know exactly what's happening, saving time and frustration across sessions.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 11 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is claude-code-iterm2-tab-status?

This Python plugin for the Claude code CLI displays live status of Claude Code sessions directly in your iTerm2 tab titles: lightning bolt for running, sleep for idle, and red circle with orange flashing for attention-needed states. It solves the chaos of juggling multiple Claude Code tabs, where you waste time switching to check if Claude is processing, done, or waiting for input—no more blind tab hunting. Install via Claude code install in the plugin marketplace, and it auto-sets up an iTerm2 Python runtime on first use.

Why is it gaining traction?

Unlike basic Claude GitHub integrations or copilot-style tools, it hooks into Claude Code's official hooks API for real-time signals without screen scraping, delivering persistent prefixes, flashing tabs, and optional macOS notifications for attention states. Developers love the zero-config start, slash commands like /iterm2-tab-status:config for tweaks, and hot-reloadable JSON/env vars—customize flash colors or badges instantly. For Claude GitHub plugin users facing connector issues, this adds visual clarity to code review or generation workflows.

Who should use this?

Mac iTerm2 users running parallel Claude Code CLI sessions for code gen, debugging, or Claude GitHub code review tasks. Ideal for full-stack devs handling multiple projects, AI prompt engineers testing skills across tabs, or teams dodging claude code down interruptions with at-a-glance status.

Verdict

Worth a quick Claude code download for heavy Claude Code CLI users—solid docs and MIT license make it easy to try, despite 10 stars and 1.0% credibility signaling early maturity. Test it if tab status saves you time; skip if not on iTerm2.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.