# 使用 Homebrew 安装 circleci

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

## 安装

```sh
sudo av install brew:circleci
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install circleci
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:circleci
- **软件包管理器:** Homebrew
- **版本:** 0.1.38646
- **来源摘要:** Enables you to reproduce the CircleCI environment locally
- **主页:** <https://circleci.com/docs/guides/toolkit/local-cli/>
- **仓库:** <https://github.com/CircleCI-Public/circleci-cli>
- **最后更新:** 2026-07-27T22:04:00+02:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- circleci (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

CircleCI CLI is CircleCI's official command-line interface for validating and processing configuration, running local jobs, querying CircleCI APIs, managing orbs and contexts, and, in newer preview builds, managing runs, workflows, deployments, environment variables, and MCP integration.

### 项目历史

The CircleCI-Public/circleci-cli repository was created in June 2018. CircleCI's installation docs identify it as the newer open-source CLI and include migration instructions for users who had the old CLI installed before October 2018.

The current main-branch README states that main tracks a preview rewrite and that the stable CLI remains separately installable. That same README describes the v1 preview as a ground-up rewrite with run, deploy, workflow, pipeline, envvar, JSON-output, shell-completion, and MCP support.

### 采用历史

CircleCI's docs recommend package managers for most installations and document Homebrew for macOS, Snap for Linux, Chocolatey for Windows, manual GitHub release downloads, and a curl-based installer. The README adds winget and a CircleCI tap for preview builds.

Homebrew currently packages stable v0.1.38646 from the official Git repository and reports thousands of 90-day install-on-request events, reflecting routine developer-tool usage among CircleCI users.

### 使用方式

Official docs emphasize validating .circleci/config.yml before pushing, processing and packing configs, running local jobs in containers, managing orbs, managing contexts, and using an API token generated from CircleCI account settings during setup.

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

CircleCI CLI is important to package-manager culture because it is the local companion binary for a hosted CI/CD platform. Its packaging has to track both stable and preview channels, multiple OS package managers, authentication setup, and a fast-moving cloud API surface.

### 时间线

- 2018-06-19: CircleCI-Public/circleci-cli repository created.
- 2018-10: CircleCI docs describe switching users from the pre-October-2018 legacy CLI to the newer open-source CLI.
- 2026: Main branch README documents a preview v1 rewrite.
- 2026-06-29: GitHub releases include v1.0 preview builds.
- 2026: Homebrew packages stable v0.1.38646.

### Related projects

- circleci/local-cli is the old CLI referenced by CircleCI's upgrade instructions.
- CircleCI orbs and the orb development kit are major workflows exposed through the CLI.
- FYAML is the configuration packing scheme linked from CircleCI CLI docs.
- CircleCI's VS Code extension is presented in the docs as another way to validate CircleCI configuration.

### 来源

- <https://circleci.com/docs/guides/toolkit/local-cli/>
- <https://circleci.com/docs/guides/toolkit/how-to-use-the-circleci-local-cli/>
- <https://github.com/CircleCI-Public/circleci-cli#readme>
- <https://api.github.com/repos/CircleCI-Public/circleci-cli>
- <https://api.github.com/repos/CircleCI-Public/circleci-cli/releases>
- <https://formulae.brew.sh/api/formula/circleci.json>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals


## 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: ~/.circleci/cli.yml

## Credential files

- Unix: ~/.circleci/cli.yml

## Combined YAML source

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


## 来源

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