# circleci を Homebrew でインストール

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