Skip to content

gitlab_pipeline_status

Latest CI pipeline run for a GitLab project as a pass/fail badge, short text line, or status rollup.

Kind	Safety	Shapes
cached	Safe	`badge`, `text`, `entries`

Options

Option	Type	Required	Default	Description
`host`	hostname	no	gitlab.com	GitLab instance host. Use this for self-hosted GitLab.
`project`	"group/name" or "group/sub/name"	no	git remote of cwd	Project to query. Falls back to the current directory's GitLab remote.
`branch`	string	no	—	Branch (ref) to filter the latest pipeline by. Omit for the most recent pipeline on any branch.

Compatible renderers

Shape	Renderers
`badge`	`animated_boot`, `animated_postfx`, `animated_scanlines`, `animated_splitflap`, `animated_wave`, `status_badge`
`text`	`animated_boot`, `animated_figlet_morph`, `animated_postfx`, `animated_scanlines`, `animated_splitflap`, `animated_typewriter`, `animated_wave`, `text_ascii`, `text_plain`
`entries`	`animated_boot`, `animated_postfx`, `animated_scanlines`, `animated_splitflap`, `animated_wave`, `grid_table`

Preview

`badge` via `status_badge`

● main · passing

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

`text` via `text_ascii`

         ▀                                   ▀                                  
█▄█▖▝▀▙ ▝█  █▀▙             ▜▞▜▖▝▀▙ ▟▀▀ ▟▀▀ ▝█  █▀▙ ▟▀▟▘                        
█▜▜▌▟▀█  █  █ █             ▐▙▟▘▟▀█ ▝▀▙ ▝▀▙  █  █ █ ▜▄█                         
▀ ▝▘▝▀▝▘▝▀▘ ▀ ▀             ▟▙  ▝▀▝▘▀▀▘ ▀▀▘ ▝▀▘ ▀ ▀ ▄▄▛

[[widget]]
id = "gitlab_pipeline_status"
fetcher = "gitlab_pipeline_status"
render = "text_ascii"

`text` via `text_plain`

main · passing

[[widget]]
id = "gitlab_pipeline_status"
fetcher = "gitlab_pipeline_status"
render = "text_plain"

`entries` via `grid_table`

status                           passing
branch                              main
sha                             abc123de
duration                          3m 12s

[[widget]]
id = "gitlab_pipeline_status"
fetcher = "gitlab_pipeline_status"
render = "grid_table"