# Install codecov-cli with Homebrew, Nix, chocolatey Codecov's command-line interface. Version 11.3.1 via Homebrew; verified 2026-07-10. Also installable with nix: nix profile install nixpkgs#codecov-cli. ## Install ```sh sudo av install brew:codecov-cli ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install codecov-cli ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#codecov-cli ``` Evidence: nixpkgs package indexes: pkgs/by-name/co/codecov-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ### Windows - Chocolatey (92%): ```sh choco install codecov ``` Evidence: Chocolatey community package catalog: codecov from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','cloudquery' ## Package facts - **Package key:** brew:codecov-cli - **Package manager:** Homebrew - **Package manager page:** - **Version:** 11.3.1 - **Source summary:** Codecov's command-line interface - **Homepage:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-07-10T07:07:50Z - **Generated:** 2026-08-04T22:13:35+00:00 ## Executables - codecov (cli) - codecov-cli (cli) - codecovcli (cli) - codecov (alias) - codecov-cli (alias) - codecovcli (alias) ## Dependencies - certifi - libyaml - python@3.14 ## Build dependencies - rust ## 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-08-04 - Package-manager version: 11.3.1 - Package-manager updated: 2026-07-10 - Local data: ok - Upstream repository: https://cli.codecov.io/ - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage Codecov CLI is Codecov's official command-line client for uploading coverage and interacting with Codecov from a terminal or CI system. It replaces or complements older uploader workflows with commands for creating commits, creating reports, uploading coverage, selecting PR bases, sending notifications, and related CI automation. ### Project history The GitHub repository was created on 2022-02-17, and the first release metadata available through GitHub shows v0.1.0 on 2023-02-28. The official README and docs describe the CLI as a way for users to interact with Codecov directly from the terminal or CI platform. Codecov's docs explicitly position the CLI as a replacement path for the NodeJS binary uploader in upload workflows, with installation either through `pip install codecov-cli` or signed binary downloads from `cli.codecov.io` and GitHub releases. ### Adoption history The input package facts list Homebrew, Chocolatey, and Nix packages, while the official docs document pip and binary installation. That mix is typical for a CI utility expected to run on developer laptops and heterogeneous CI images. Because Codecov is used inside CI, adoption is workflow-driven: projects add the CLI to CI steps, pass coverage reports, and authenticate with repository or organization upload tokens. ### How it is used The official docs show `codecovcli upload-process` as the wrapper for create-commit, create-report, and do-upload, and describe options such as upload token, file selection, flags, slug, branch, PR, and CI parameter auto-loading. Codecov configuration is controlled through Codecov YAML. The docs state that repository YAML is stored as a standalone `codecov.yml` file in the repository, and the FAQ allows `codecov.yml` or `.codecov.yml` in the repository root, `dev/`, or `.github/` directories. The current curation records the common `codecov.yml` and `.github/codecov.yml` paths. ### Why package nerds care Codecov CLI is important package-manager plumbing because it is a small executable that many CI pipelines depend on for coverage upload. Its packaging surface spans Python packaging, signed standalone binaries, Homebrew, Chocolatey, and Nix, which makes it a cross-platform delivery problem rather than only a Python library. For package maintainers, it also reflects a broader shift away from ad hoc shell uploaders toward signed, versioned, auditable CLI tools in CI supply chains. ### Timeline - 2022-02-17: GitHub repository created. - 2023-02-28: v0.1.0 release published. - 2023: Official README documents pip and binary installation plus replacement of the NodeJS binary uploader. - 2026-04-21: v11.2.x releases published, showing a mature release line. ### Related projects - Related Codecov projects include the older NodeJS binary uploader, Codecov's coverage service, Codecov YAML configuration, Codecov GitHub/GitLab/Bitbucket integrations, and Codecov self-hosted or enterprise installations referenced in the official docs. ### Sources - - - ## Security Notes No matching local secret-handling manifest was found for codecov-cli. Package metadata is still published here so future coverage has a stable package URL. ## 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: codecov.yml, .github/codecov.yml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** codecov-cli - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - codecov-cli: normalized package name match | nixpkgs package indexes: pkgs/by-name/co/codecov-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Chocolatey - codecov: installed executable or alias match | Chocolatey community package catalog: codecov from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','cloudquery' ## Related links - [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://pkg.so/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://pkg.so/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [Networking and protocol packages](https://pkg.so/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [python@3.14](https://pkg.so/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [rust](https://pkg.so/brew/rust/) - Build dependency declared by Homebrew. - [lcov](https://pkg.so/brew/lcov/) - Shares pkgdb curated category or tags: cli, coverage, developer-tools, testing. - [act](https://pkg.so/brew/act/) - Shares pkgdb curated category or tags: ci-cd, cli, developer-tools. - [kcov](https://pkg.so/brew/kcov/) - Shares pkgdb curated category or tags: cli, coverage, developer-tools, testing. - [circleci](https://pkg.so/brew/circleci/) - Shares pkgdb curated category or tags: ci-cd, cli, developer-tools. - [gcovr](https://pkg.so/brew/gcovr/) - Shares pkgdb curated category or tags: cli, coverage, developer-tools, testing. - [tox](https://pkg.so/brew/tox/) - Shares pkgdb curated category or tags: ci, cli, developer-tools, testing. - [dagger](https://pkg.so/brew/dagger/) - Shares pkgdb curated category or tags: ci-cd, cli, developer-tools. - [bitrise](https://pkg.so/brew/bitrise/) - Shares pkgdb curated category or tags: ci-cd, cli, developer-tools. - [codecov.io](https://pkg.so/npm/codecov-io/) - Executable or command metadata overlaps with this package. Shared terms: cli, codecov, coverage, developer, developer-tools. - [http-prompt](https://pkg.so/brew/http-prompt/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, command-line, developer, developer-tools. ## Combined YAML source View the package source record on GitHub. [combined/codecov-cli.yml](https://github.com/mxcl/pkgdb/blob/main/combined/codecov-cli.yml) ## Sources - pkg.so package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - pkgdb category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph