Session Auto-Color Rules (keyword-based or project-inherited automatic session coloring)
Auto-Color Rules give sessions a colour bar — and, if you add one, their own icon — automatically, so you never colour-code by hand. One mode makes every session inherit its project's colour; the other matches keywords against the session title in an ordered list, first match wins. A colour you set manually always outranks both.
On this page
What it is
Auto-Color Rules automatically assign a color bar to sessions based on user-defined rules, so you never have to color-code sessions by hand. Two modes, mutually exclusive:
- Match project color (toggle ON): every session inherits the color of its parent project. Keyword rules are ignored entirely.
- Keyword rules (toggle OFF): an ordered list of keyword rules. When a session is created or renamed, the title is checked against each keyword in order; the first case-insensitive substring match wins and sets the session's color bar — and its icon, if that rule has one.
The icon is optional and belongs to the rule, not the session. Pick an emoji, a line icon or a brand mark from the same picker projects use, or leave it empty. A session that matches a rule with an icon wears that mark in place of its status dot, drawn in the status colour — so the mark says which thing this session is, and its colour still says how it is doing (green running, amber needs you). The only icon this app used to draw that way was the crescent moon on Nighty Tidy rows; a rule lets you give any set of sessions its own mark without touching code.
Priority (top wins, no exceptions):
- Manual color -- if you've set a color on a session by hand, auto-color never overwrites it. (A rule's icon still fills in on such a session; only the colour is protected.)
- Project color -- when the toggle is ON, the session inherits its project's color.
- Keyword rules -- when the toggle is OFF, rules are evaluated top-to-bottom, first match wins — for the colour and the icon together.
Each output fills only when it is empty: a colour is never changed once set, and an icon is never changed once set. Neither is ever cleared.
Where to find it
Where it lives in the UI
Settings > Sessions > Auto-Color Rules subsection.
- A Match project color toggle at the top.
- Below it, a Keyword rules card with drag-to-reorder rows. Each row has a color swatch (click to pick), an icon button (click to pick an emoji, line icon or brand mark, or "No icon" to clear it), a text field for the keyword, and a delete button. An "Add Rule" button appends a new row.
- An Apply to Existing Sessions button at the bottom retroactively applies the current rules to all sessions that are missing a color or an icon.
When Match project color is ON, the keyword rules card is a genuinely disabled fieldset — dimmed AND out of the tab order, so it cannot be edited or deleted by keyboard either.
How it behaves
How to use it
- Open Settings > Sessions and scroll to Auto-Color Rules.
- To use project colors: flip Match project color ON. Every session will inherit its project's color (if the project has one set).
- To use keyword rules: leave the project toggle OFF. Click Add Rule, type a keyword (e.g. "bugfix"), click the color swatch to pick a color, then click the icon button to give the rule a mark. Drag rows to reorder priority.
- Name the sessions your script spawns with that keyword — e.g. a script that titles its sessions
[My Script] …and a rule keyed on[My Script]— and every session it starts wears the mark from then on. - Click Apply to Existing Sessions to retroactively colour and mark sessions that match but were created before you set up rules.
Related
- session-title-style.md — the sibling control that decides how a session is named.
- session-menu-customization.md — the other per-session appearance control in the same settings area.
- settings/appearance.md — the settings reference where the auto-color rules live.
Last verified 2026-11-18