Skip to main content
plugin

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add ccplugins/awesome-claude-code-plugins
/plugin install claude-session-tint@awesome-claude-code-plugins
Open on GitHub

What 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-plugins

Step 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

Similar plugins

All plugins for Notes, tasks and projects →

From the same set184

The whole set →
email-marketing-architect email-marketing-architect designs email marketing programs with lifecycle drip sequences, segmentation rules, and an HTML report. CX Codex +1 ★ 1,013repo stars seo-content-planner seo-content-planner is a Claude Code command that builds an SEO strategy, from keyword targets to a 90-day publishing calendar. It checks the conversation for earlier analysis first. CX Codex +1 ★ 1,013repo stars community-building-strategist community-building-strategist — a slash command that interviews you about community goals, then turns the answers into an HTML strategy: platform, channels, roles, rituals, moderation, metrics. CX Codex +1 ★ 1,013repo stars session-tax session-tax measures token overhead in Claude Code opening context before you type. It reveals how many tokens load from unused skills, hooks, and tool schemas. ★ 1,013repo stars rote rote turns a skill you already trust into a deterministic pipeline with no model in the loop, then serves the compiled result back to Claude as an MCP tool. ★ 1,013repo stars bullpen bullpen — a set of skills that brings senior engineer instincts into Claude Code. It helps challenge bad assumptions, attack code before shipping, and verify results before marking tasks done. ★ 1,013repo stars slicewise slicewise breaks feature work into small slices, runs a test gate, compares two independent reviews, and leaves the commit decision to you. ★ 1,013repo stars craftsman craftsman is a Claude Code plugin with agents, skills and hooks that keeps changes within scope, finds a bug's root cause and reports what was verified. ★ 1,013repo stars

Project sponsors

Companies that keep this analytics open