- Accepts:
timeline
- Animates: no
| Option | Type | Required | Default | Description |
|---|
bullet | "●" | "•" | "▪" | "→" | "none" | no | none | Glyph prefixed to each event after the time column. none (default) shows only the time column and title. |
max_items | positive integer | no | all events | Cap on rendered events, from the top. Older events are dropped when the list is longer than the cap. |
date_format | "relative" | "absolute" | no | "relative" | How the time column is formatted. relative shows 2h / 3d; absolute shows 2026-04-23 (ISO date). |
align | "left" | "center" | "right" | no | "left" | Horizontal alignment of the timeline within its cell. |
Overridable via the [theme] section of config.toml.
| Key | Description |
|---|
status_ok | Healthy / passing status (badges, table rows, timeline titles). |
status_warn | Degraded / warning status — visually distinct from both ok and error. |
status_error | Failing / error status — reserved for attention-grabbing failures. |
text_dim | Barely-visible chrome text: timeline date prefixes, empty-state placeholder, clip hint. Replaces the old Modifier::DIM usage — set an explicit colour so rendering stays consistent across terminals (some render DIM as invisible, some as a no-op). |
text_secondary | Slightly-less-dim secondary text, e.g. the detail line under a timeline entry. |
text | Primary body text colour for plain renderers (text_plain, text_ascii, list_plain, animated_typewriter). The top step of the chrome ladder — brighter than text_secondary, reads as diffuse daylight on the ocean surface. Set text = "reset" to inherit the terminal's own foreground instead. |