iterm2-status

iTerm2 Status Control

Manually control iTerm2 visual status indicators for Claude Code sessions.

Available States

State	Tab Color	Badge	Title Prefix
working	Blue	Working...	[...]
waiting	Yellow (gradient to orange)	Input Needed	[?]
done	Green	Done	[OK]
error	Red	Error	[!]
reset	Default	Cleared	Directory name

Usage

${CLAUDE_PLUGIN_ROOT}/dist/cli.cjs working "my-project"
${CLAUDE_PLUGIN_ROOT}/dist/cli.cjs waiting "my-project"
${CLAUDE_PLUGIN_ROOT}/dist/cli.cjs done "my-project"
${CLAUDE_PLUGIN_ROOT}/dist/cli.cjs error "my-project"
${CLAUDE_PLUGIN_ROOT}/dist/cli.cjs reset
${CLAUDE_PLUGIN_ROOT}/dist/cli.cjs status

Features

• Tab colors visible in iTerm2's tab bar
• Badge text in tab corner
• Desktop notifications (on done)
• Sound notifications (configurable)
• Gradient animation for waiting state (yellow to orange over 60s)
• Auto-transition from done to waiting after 60s