Smart Color

TokenEater colors your usage with three independent systems, each answering a different question. Together they tell you, at a glance, whether you're fine, drifting, or about to hit the wall.

The three systems

Threshold gauge -> "how full is this bucket right now?" A static three-color mapping (green / orange / red) based on percentages you set. Used as a fallback, or when Smart Color is disabled.
Smart gauge -> "what's my real risk of overshooting before the next reset?" A continuous risk model combining absolute usage, rhythm projection, and pacing. Enabled by default since v5.0.
Pacing zones -> "am I keeping the ideal rhythm?" Independent of gauge color, drives pacing badges, dots, track bars, and zone labels.

Threshold and Smart are alternatives - one or the other for a given gauge. Pacing always stays independent, complementary to the active gauge system.

Three profiles, three temperaments

When Smart Color is enabled, you choose a profile in Settings -> Themes -> Smart Color -> Sensitivity. Each tunes the algo to match a different risk appetite.

	Patient	Balanced	Vigilant
Idea	Trusts bursts	The middle ground	Reads early signals
Confidence (k)	`3`	`5`	`8`
Projection saturation	160%	140%	120%
Absolute bounds	55% - 105%	50% - 100%	45% - 90%
For whom	Stable usage, anti false positive	Most people	Catch issues before they hit

Threshold sliders are hidden when Smart Color is enabled - the profile owns calibration in smart mode. Sliders only drive the simple threshold mode.

Where each system applies

Menu bar percentages, reset countdown, dashboard rings, popover gauges, widgets -> smart by default, threshold fallback
Pacing pills, dots, track bars, zone labels -> pacing zones (independent system)
Notifications -> smart-aware. When Smart Color is enabled, escalations align with gauge color so the bell never rings while the gauge stays green

For the detailed mechanics of the Smart algo - risk components, formulas, HSB interpolation - see Smart Color in detail.