install

Additional install commands

macOS

Homebrewverified · 100%

brew install gitlab-ci-local

provider-native install command

overview

Package summary

Run gitlab pipelines locally as shell executor or docker executor

Project links

Homepage

Commands and aliases

gitlab-ci-local

history

Project history and usage

gitlab-ci-local is a command-line runner for executing GitLab CI pipelines on a developer machine with shell or Docker executors. It is built around the recurring developer problem described by its README: avoiding repeated pushes just to discover whether `.gitlab-ci.yml` behaves as expected.

Project history

The GitHub repository was created in January 2020. The README positions the tool as a replacement for project-specific shell scripts and make targets by letting developers run the same GitLab CI jobs locally.

The project expanded beyond a basic runner into a package with Debian repository instructions, AUR packaging, npm and Bun installation, Homebrew installation, Windows Git Bash support, dotenv-style defaults, tab completion, job listing modes, and documented behavior for includes, artifacts, variables, and local-only jobs.

Adoption history

gitlab-ci-local's adoption follows the spread of GitLab CI into projects that wanted faster feedback than remote pipeline runs. Repository metadata collected for this enrichment reported 3,978 GitHub stars, and the package is distributed through npm, Homebrew, distro-oriented channels, and Arch's AUR.

Its ecosystem significance comes from matching GitLab CI's YAML-centered workflow while accepting that a local runner has boundaries. The README documents tracked-file behavior, local-only rules, variables from home and project files, remote variables, and artifact handling so teams can decide what belongs in local feedback and what belongs in GitLab.

How it is used

Practitioners install the CLI, run `gitlab-ci-local` in a repository, use `.gitlab-ci-local-env` or `$HOME/.gitlab-ci-local/.env` for default CLI options, and use variables files to model CI/CD variables. They also use `--list`, `--list-all`, and CSV listing modes to inspect planned jobs before executing a pipeline.

Why package nerds care

For package nerds, gitlab-ci-local is interesting because it turns a hosted CI product's YAML dialect into a local executable distributed through several package ecosystems. It is the sort of package that saves time in inner-loop development while surfacing the hard parts of reproducing CI outside the hosted service.

Timeline

2020: Repository created for local GitLab CI execution.
2020: README described running GitLab pipelines locally as shell or Docker executor.
2024: npm package metadata exposed the `gitlab-ci-local` binary entry point.
2026: v4.73.0 release published on GitHub.

Related projects

Related surfaces include GitLab CI, Docker, shell executors, npm, Bun, Homebrew, Debian packaging, AUR, and Git Bash on Windows.

Sources

security posture

Risk level: yellow

generalized runtime or code generation signal.

Risk classifier

yellow risk · medium confidence · runtime

Why

generalized runtime or code generation signal

Signals

text:shell

Install behavior

No Homebrew bottle metadata was recorded.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix: .gitlab-ci.yml.gitlab-ci-local-env~/.gitlab-ci-local/.env

executables

Installed executables

Command	Kind	Exposure	Note
`gitlab-ci-local`	executable	indexed executable	Discovered from the local executable index.

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-08-03

manager version4.74.0

manager updated2026-08-01

local dataunknown

upstreamnot available

latest detectednot detected

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:gitlab-ci-local
Version	4.74.0
Package manager	Homebrew
Homepage	https://github.com/firecow/gitlab-ci-local
Last updated	2026-08-01T12:21:26Z
Pulse	updated
Bottle	not recorded
Service	none declared

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/gitlab-ci-local.yml

Used sources

Geiger risk classifier
Nucleus package database
curated configuration and credential file locations
curated package history
pkgdb category and tag curation

Install gitlab-ci-local with Homebrew