list_timeline

Chronological events with a left-aligned time column (relative 3h / 2d or absolute ISO date) separated from the title by a vertical bar, and an optional indented detail row underneath. Status colours the title; pick this for commits, releases, notifications.

Accepts	Animates
timeline	no

Options

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.

Theme tokens

Overridable via the [theme] section of your dashboard config.

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.

Compatible fetchers

Shape

Fetchers

timeline

basic_timeline, claude_subscription, codex_subscription, deal_free_games, deal_games, deal_steam_daily, deariary_on_this_day, deariary_recent, git_age, git_recent_commits, github_action_history, github_assigned_issues, github_good_first_issues, github_my_prs, github_notifications, github_recent_releases, github_repo_issues, github_repo_prs, github_review_requests, gitlab_my_mrs, gitlab_repo_issues, gitlab_repo_mrs, gitlab_review_requests, lastfm_scrobbles_today, linear_issues, linear_notifications, lobsters_top, news_9to5google, news_9to5mac, news_a_list_apart, news_ai_news, news_aljazeera, news_android_authority, news_android_police, news_appleinsider, news_arstechnica, news_bbc, news_bleeping_computer, news_bloomberg, news_carbon_brief, news_cbs, news_coindesk, news_css_tricks, news_daring_fireball, news_dark_reading, news_deadline, news_decrypt, news_distrowatch, news_dpreview, news_dw, news_economist, news_engadget, news_eurogamer, news_forbes, news_fortune, news_france24, news_fstoppers, news_ft, news_gizmodo, news_graham_cluley, news_guardian, news_hackaday, news_hackernoon, news_hugging_face_blog, news_ifixit, news_ign, news_import_ai, news_indiewire, news_inside_climate, news_its_foss, news_kotaku, news_krebs, news_lwn, news_macrumors, news_marketwatch, news_mit_tr_ai, news_nasa_news, news_nature, news_new_scientist, news_npr, news_omg_ubuntu, news_pc_gamer, news_petapixel, news_phoronix, news_phys_org, news_pitchfork, news_politico, news_polygon, news_propublica, news_quanta_magazine, news_rockpapershotgun, news_schneier, news_sciencedaily, news_scientific_american, news_sky_news, news_slashdot, news_smashing_magazine, news_space_com, news_spacenews, news_stereogum, news_techcrunch, news_techpowerup, news_techradar, news_the_block, news_the_gradient, news_the_hacker_news, news_the_register, news_theverge, news_threatpost, news_tomshardware, news_universe_today, news_ux_collective, news_variety, news_venturebeat, news_vg247, news_vox, news_wired, news_wsj, news_xda, news_yahoo_finance, news_yale_climate, news_zdnet, rss, todoist_tasks, weather_forecast, wikipedia_on_this_day, youtube_channel

Preview

timeline

2023-11-14 │ merged #42                           
           │ feat(render): heatmap                
2023-11-14 │ opened #41                           
2023-11-13 │ reverted #40                         
                                                  
                                                  
                                                  
                                                  

[[widget]]
id = "git_recent_commits"
fetcher = "git_recent_commits"
render = "list_timeline"