iTerm2 visual status indicators and grid layouts for Claude Code
npx claudepluginhub banyudu/claude-iterm2iTerm2 visual status indicators and grid layouts for Claude Code
iTerm2 visual status indicators and grid layouts for Claude Code.
# Add the marketplace (one-time)
claude plugin marketplace add banyudu/claude-iterm2
# Install the plugin
claude plugin install iterm2@claude-iterm2
Dependencies (tsx) are automatically installed on first session start via a SessionStart hook — no manual npm install required.
git clone [email protected]:banyudu/claude-iterm2.git
cd claude-iterm2 && npm install
Then add it to your local marketplace or symlink it into ~/.claude/plugins/.
Restart Claude Code to activate. Hooks auto-register and tab colors start working immediately.
brew install terminal-notifier
Just use Claude Code normally. Tab colors update automatically:
/iterm2:setup # Interactive feature selection
/iterm2:config # View or change settings
/iterm2:config set badge false # Disable badge text
Settings are stored in ~/.config/claude-iterm2/config.json.
/iterm2:grid 2x2 # 4-pane grid
/iterm2:grid 3x3 # 9-pane grid
/iterm2:fork # Fork into vertical split (default)
/iterm2:fork --horizontal # Fork into horizontal split
/iterm2:fork --tab # Fork into a new tab
/iterm2:status working # Blue tab
/iterm2:status done # Green tab
/iterm2:status reset # Reset to default
| Setting | Type | Default | Description |
|---|---|---|---|
| tabColor | bool | true | Tab color changes (blue/yellow/green/red) |
| badge | bool | true | Badge text watermark (Working.../Done/etc.) |
| notification | bool | true | Desktop notifications on completion |
| sound | bool | true | Sound notifications |
| gradient | bool | true | Gradient animation for waiting state |
| doneToWaiting | bool | true | Auto-transition from done to waiting |
| gradientDuration | number | 60 | Gradient duration (seconds) |
| doneToWaitingDelay | number | 60 | Done-to-waiting delay (seconds) |
| cacheTimeout | number | 300 | Cache expiry timeout in seconds (set 3600 for Claude Max) |
Environment variables (e.g., AI_ENABLE_TAB_COLOR=0) override saved settings.
terminal-notifier (optional, for desktop notifications)MIT