# 使用 Homebrew, Nix 安装 gitlab-ci-local

查看 gitlab-ci-local 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:gitlab-ci-local
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install gitlab-ci-local
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#gitlab-ci-local
```

  证据: nixpkgs package indexes: pkgs/by-name/gi/gitlab-ci-local/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:gitlab-ci-local
- **软件包管理器:** Homebrew
- **版本:** 4.74.0
- **来源摘要:** Run gitlab pipelines locally as shell executor or docker executor
- **主页:** <https://github.com/firecow/gitlab-ci-local>
- **最后更新:** 2026-08-01T12:21:26Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- gitlab-ci-local (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 4.74.0
## 项目历史与用法

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.

### 项目历史

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.

### 采用历史

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.

### 使用方式

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.

### 为什么软件包爱好者会关心

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.

### 时间线

- 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.

### 来源

- <https://api.github.com/repos/firecow/gitlab-ci-local>
- <https://formulae.brew.sh/formula/gitlab-ci-local>
- <https://github.com/firecow/gitlab-ci-local>
- <https://github.com/firecow/gitlab-ci-local/releases/tag/4.73.0>
- <https://raw.githubusercontent.com/firecow/gitlab-ci-local/master/README.md>
- <https://www.npmjs.com/package/gitlab-ci-local>


## 安全说明

generalized runtime or code generation signal.

- **Geiger 风险:** yellow / 中
- generalized runtime or code generation signal


## 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

- Unix: .gitlab-ci.yml, .gitlab-ci-local-env, ~/.gitlab-ci-local/.env
## 其他软件包管理器记录

- Nix - gitlab-ci-local: normalized package name match | nixpkgs package indexes: pkgs/by-name/gi/gitlab-ci-local/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/gitlab-ci-local.yml](https://github.com/mxcl/pkgdb/blob/main/combined/gitlab-ci-local.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
