status_badge

A coloured dot (green / yellow / red, driven by status) followed by the badge label, optionally framed as a ( … ) or [ … ] pill. One indicator per widget — compose rows of badges through layout, not through this renderer.

Accepts	Animates
`badge`	no

Options

Option	Type	Required	Default	Description
`shape`	"rounded" \| "square" \| "none"	no	"none"	Pill framing. `rounded` wraps the label in `( … )`, `square` in `[ … ]`, `none` (default) leaves the bare dot + label.
`padding`	cells (u16)	no	0	Horizontal padding inside the pill, before the dot and after the label.
`align`	"left" \| "center" \| "right"	no	"left"	Horizontal placement of the pill 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`	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

badge basic_badge, claude_code_usage, claude_subscription, clock_state, code_comments, code_largest_files, code_loc, codex_subscription, codex_usage, crypto_watchlist, deal_free_games, deal_games, deal_steam_daily, deariary_on_this_day, deariary_recent, deariary_today, git_age, git_stash_count, git_status, github_action_status, github_assigned_issues, github_my_prs, github_notifications, github_repo_issues, github_repo_prs, github_repo_stars, github_review_requests, gitlab_my_mrs, gitlab_pipeline_status, gitlab_repo_issues, gitlab_repo_mrs, gitlab_repo_stars, gitlab_review_requests, lastfm_scrobbles_today, lastfm_top_albums, lastfm_top_artists, lastfm_top_tracks, linear_cycle, linear_issues, linear_notifications, net_gateway, net_interfaces, net_ip, net_mac, net_proxy, net_speedtest, steam_charts, steam_owned_games, steam_player_summary, steam_recently_played, stock_watchlist, system_monitor_battery, todoist_tasks, weather, weather_forecast

Shape	Fetchers
`badge`	`basic_badge`, `claude_code_usage`, `claude_subscription`, `clock_state`, `code_comments`, `code_largest_files`, `code_loc`, `codex_subscription`, `codex_usage`, `crypto_watchlist`, `deal_free_games`, `deal_games`, `deal_steam_daily`, `deariary_on_this_day`, `deariary_recent`, `deariary_today`, `git_age`, `git_stash_count`, `git_status`, `github_action_status`, `github_assigned_issues`, `github_my_prs`, `github_notifications`, `github_repo_issues`, `github_repo_prs`, `github_repo_stars`, `github_review_requests`, `gitlab_my_mrs`, `gitlab_pipeline_status`, `gitlab_repo_issues`, `gitlab_repo_mrs`, `gitlab_repo_stars`, `gitlab_review_requests`, `lastfm_scrobbles_today`, `lastfm_top_albums`, `lastfm_top_artists`, `lastfm_top_tracks`, `linear_cycle`, `linear_issues`, `linear_notifications`, `net_gateway`, `net_interfaces`, `net_ip`, `net_mac`, `net_proxy`, `net_speedtest`, `steam_charts`, `steam_owned_games`, `steam_player_summary`, `steam_recently_played`, `stock_watchlist`, `system_monitor_battery`, `todoist_tasks`, `weather`, `weather_forecast`

Preview

`badge`

● passing

[[widget]]
id = "github_action_status"
fetcher = "github_action_status"
render = "status_badge"