Skip to content
Productivity
Hook

Hooks

What iterm2-tab-status runs automatically, and when. A hook is a command Claude Code fires at a fixed moment, without you asking for it.

Install
$ npx -y skills add JasperSui/claude-code-iterm2-tab-status --agent claude-code

Ships with iterm2-tab-status. Installing the plugin gets these hooks.

What fires, and when

SessionStart

Fires once when a session begins, and again after a context compaction. It is where a plugin sets up its environment, or restores state the compaction dropped.

  • Runs bootstrap.sh.

Notification

  • Runs hook.sh.

Stop

  • Runs hook.sh.

UserPromptSubmit

Fires before Claude sees each prompt you send. A plugin can use it to inject context, so the same instruction reaches the model every turn instead of only at session start.

  • Runs hook.sh.
Read hooks/hooks.json
Ships withiterm2-tab-status

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

Get the whole plugin, auto-invoked
Stats
38
Stars
0
Views
10
Forks
Maintained
Maintenance
Python
Language
MIT
License
1mo ago
Last commit
5mo ago
Created

Repo: JasperSui/claude-code-iterm2-tab-status