chart_histogram

Vertical bar chart from a NumberSeries, binned into equal-width buckets. Optional axis_labels print the peak count along the top edge and the value range along the bottom; pairs with chart_sparkline when the same series should look bigger and shaped instead of compact.

Accepts	Animates
number_series	no

Options

Option	Type	Required	Default	Description
label	string	no	—	Optional inline prefix rendered to the left of the histogram bars.
bins	positive integer	no	auto	Number of buckets the input is binned into. Auto picks ceil(sqrt(n)) clamped to [5, area width]; explicit values clamp to [1, area width].
axis_labels	bool	no	false	Render the value range (min / max) along the bottom edge and the peak bucket count along the top edge. Auto-skipped when the chart area is shorter than 4 rows so bars keep usable space.

Theme tokens

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

Key	Description
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.
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).

Compatible fetchers

Shape	Fetchers
number_series	basic_numbers, basic_read_store, claude_code_usage, code_largest_files, code_loc, codex_usage, crypto_watchlist, git_age, git_commits_activity, github_action_history, github_contributions, lastfm_top_albums, lastfm_top_artists, lastfm_top_tracks, linear_cycle, steam_charts, steam_owned_games, steam_recently_played, stock_watchlist, weather, weather_forecast

Preview

number_series

        ████████████████                
▆▆▆▆▆▆▆▆████████████████▆▆▆▆▆▆▆▆        
████████████████████████████████        
████████████████████████████████▃▃▃▃▃▃▃▃
████████████████████████████████████████
████████████████████████████████████████

[[widget]]
id = "git_commits_activity"
fetcher = "git_commits_activity"
render = "chart_histogram"