claude-session-tint — Claude Code plugin: install
claude-session-tint is a Claude Code plugin that colors Terminal.app windows by project and highlights a window when a reply arrives out of focus. Shared-window tabs get a title marker instead.
MIT ★ 1,013 updated 2026-08-12
/plugin marketplace add ccplugins/awesome-claude-code-plugins
/plugin install claude-session-tint@awesome-claude-code-pluginsWhat claude-session-tint does
claude-session-tint assigns a project color to a Terminal.app window and brightens it when Claude Code finishes a reply while the window is inactive. Focusing the window clears the highlight. When tabs share a window, the plugin marks the tab title instead.
The commands ,api and ,off set and remove a window label; , opens the palette. A UserPromptSubmit hook handles these inputs without sending a request to the model. Window coloring is limited to Terminal.app on macOS, while command handling works in any terminal and on any OS. Set the palette in ~/.claude/tabtint-palette.conf; the bundled palette.conf is used as a fallback. Adjust brightness with TABTINT_IDLE_PCT and TABTINT_ATTN_PCT.
What it helps with
- tell Claude Code project windows apart
- notice a reply that arrives in an inactive window
- mark tabs that share a terminal window
- label a project without invoking the model
Example prompts for the agent
- Mark this window as API with
,api. - Show the color palette with
,. - Remove this window's label with
,off.
How to install claude-session-tint
Plugin marketplace
/plugin marketplace add ccplugins/awesome-claude-code-plugins/plugin install claude-session-tint@awesome-claude-code-pluginsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about claude-session-tint
How do I install claude-session-tint in Claude Code?
Run these commands in order: /plugin marketplace add ccplugins/awesome-claude-code-plugins, then /plugin install claude-session-tint@awesome-claude-code-plugins.
What does claude-session-tint do?
It colors Terminal.app windows by project and highlights a window when a Claude Code reply arrives while it is out of focus. For tabs sharing a window, it adds a marker to the tab title.
What does claude-session-tint need to work?
Window tinting requires Terminal.app on macOS. The command hook works in any terminal and on any OS.
Source text
claude-session-tint · MIT
# claude-session-tint Know which Claude Code session needs you. Tag a terminal window with a project. It wears that project's color quietly while it works, brightens when a response lands while you are looking elsewhere, and drops back the moment you focus it. ``` ,api tag this window "API" (no turn, no tokens, no reply) , show the palette ,off untag ``` Typing `,api` runs a command from inside a live session **without invoking the model**: a `UserPromptSubmit` hook returns `decision:"block"` with `suppressOriginalPrompt`, so Claude Code never queries the model. That pattern works on any terminal and any OS. The window coloring itself is macOS Terminal.app only, because Terminal.app is the one terminal with no native tab colors. Edit your palette at `~/.claude/tabtint-palette.conf` (falls back to the bundled `palette.conf`). Tune with `TABTINT_IDLE_PCT` and `TABTINT_ATTN_PCT`. Upstream, issues and full docs: https://github.com/dotcomjack/claude-session-tint MIT.
© DotcomJack · MIT · ccplugins/awesome-claude-code-plugins