Smart Color in detail

How a gauge turns usage into a color. For the settings, see Smart Color.

Threshold mode

• util >= critical (default 85%) -> red
• util >= warning (default 60%) -> orange
• otherwise -> green

Used when Smart Color is off, and for the Extra Credits pool, which has no time window.

Smart mode

Three risk signals, combined with max() so the worst wins:

• Absolute: how close you are to the limit, on a smooth ramp between two profile bounds. 98% used is always red.
• Projection: will this rhythm overshoot? u / e (usage over elapsed fraction) above 1 means yes. Damped early in the window, so a burst at 5% used / 1% elapsed does not alarm.
• Pacing: how far you run above the linear rhythm, beyond your pacing margin.

Projection health damps the absolute signal when your rhythm projects a finish under the limit. Example: 72% used at 4h12 of a 5-hour window, relaxed pacing. Projection health is about 0.53, absolute drops to 0.25, the gauge stays green: you will finish around 86%. At 98% used with 30 min left, it is 1 and the gauge turns red.

Profile parameters

k: how fast the rhythm is trusted. Saturation: the projected finish that reads as full risk. Bounds: where the absolute ramp starts and ends.

From score to color

Four anchors map the score to your theme's gauge colors: normal from 0 to 0.30, warning at 0.55, critical from 0.85 to 1. Between anchors, colors blend through HSB rather than linear sRGB, so mid risk shows as a clean yellow-green.

Edge cases

• Over 100%: red in both modes, pacing Hot.
• No reset date: absolute signal only. Pacing shows a sparkles glyph instead of the zone icon, with no track.
• OpenAI Codex: uses the window length the server declares, so a weekly-only plan runs on its own clock.
• Custom theme: no Watch out picker, so that zone keeps the default orange (#FF9500).
• Reduce Motion: color transitions stay, spring animations are reduced.