# Install circleci with Homebrew Enables you to reproduce the CircleCI environment locally. Version 0.1.38646 via Homebrew; verified 2026-06-03. ## Install ```sh sudo av install brew:circleci ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install circleci ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:circleci - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.1.38646 - **Source summary:** Enables you to reproduce the CircleCI environment locally - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-03T18:42:25Z - **Generated:** 2026-07-09T07:20:21+00:00 ## Executables - circleci (cli) - circleci (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-09 - Package-manager version: 0.1.38646 - Package-manager updated: 2026-06-03 - Local data: ok - Upstream repository: https://github.com/CircleCI-Public/circleci-cli - info: No cached GitHub release or tag data was available. ## Project history and usage 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. ### Project history 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. ### Adoption history 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. ### How it is used 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. ### Why package nerds care 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. ### Timeline - 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. ### Sources - - - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - 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 ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** circleci - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Related links - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [act](https://www.automicvault.com/pkg/brew/act/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools. - [brigade-cli](https://www.automicvault.com/pkg/brew/brigade-cli/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools. - [dagger](https://www.automicvault.com/pkg/brew/dagger/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools. - [gabo](https://www.automicvault.com/pkg/brew/gabo/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools. - [gama](https://www.automicvault.com/pkg/brew/gama/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools. - [gitea-runner](https://www.automicvault.com/pkg/brew/gitea-runner/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools. - [jenkins](https://www.automicvault.com/pkg/brew/jenkins/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools. - [jenkins-cli](https://www.automicvault.com/pkg/brew/jenkins-cli/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools. - [gitlab-ci-local](https://www.automicvault.com/pkg/brew/gitlab-ci-local/) - Local package facts share a topical domain. Shared terms: ci-cd, cli, developer, developer-tools, local. - [terragrunt-atlantis-config](https://www.automicvault.com/pkg/brew/terragrunt-atlantis-config/) - Local package facts share a topical domain. Shared terms: ci-cd, cli, configuration, developer, developer-tools. ## Combined YAML source View the package source record on GitHub. [combined/circleci.yml](https://github.com/automic-vault/db/blob/main/combined/circleci.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph