# firecow/gitlab-ci-local

Tired of pushing to test your .gitlab-ci.yml?

Repository: https://github.com/firecow/gitlab-ci-local
Canonical: https://ross.abutalabs.com/products/gitlab-ci-local
Language: TypeScript
License: MIT
License Family: permissive
Topics: gitlab, local, pipeline, git, ci, cd, push, untracked, uncomitted, gitlab-ci
Last push: 2026-08-26T18:46:05+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 100
- inputs: {"age_days": 2433, "days_push": 7, "days_rel": 8, "gap_med": 17.0, "n_releases_24m": 33}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4065, forks 212 (observed 2026-08-28T04:08:34.090585+00:00)

## What it is
A CLI tool that runs GitLab CI pipelines locally using shell or Docker executors, so developers can test .gitlab-ci.yml without pushing to GitLab. It is written in TypeScript and distributed via npm.

## Use cases
- test gitlab ci pipeline locally
- run .gitlab-ci.yml jobs without pushing
- debug gitlab ci jobs on my machine
- replace dev shell scripts and makefiles with gitlab ci
- run gitlab pipeline with docker executor locally
- iterate on ci config before committing

## When to choose
- you use GitLab CI and want fast local feedback on pipeline changes
- you want to debug failing CI jobs without push cycles
- you want to consolidate dev scripts into .gitlab-ci.yml

## When to avoid
- you use GitHub Actions or another CI system
- you need full parity with GitLab's hosted runners and services
- your pipeline depends on GitLab-only features like protected variables or cluster runners

## Facets
- artifact type: cli-tool
- maturity: active
- function: ci-cd, cli, developer-tools, testing
- domain: developer-tools
- platform: cli, cross-platform
- tags: gitlab-ci, local-pipeline, gitlab, docker-executor, shell-executor, devops, command-line, automation, nodejs, docker

## Member repositories
- firecow/gitlab-ci-local (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:34.090585+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:23:33.587265+00:00, confidence not recorded.
  - readme: https://github.com/firecow/gitlab-ci-local (fetched 2026-08-28T04:08:34.090585+00:00, sha c1926ac50ca2)
- Data as of 2026-08-30T08:39:29.467469+00:00.