macOS
Homebrewverified · 100%
brew install codecov-clilocal Homebrew formula metadata
brew / rank 4219
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
Additional install commands
Linux
Nixverified · 92%
nix profile install nixpkgs#codecov-clinixpkgs package indexes · pkgs/by-name/co/codecov-cli/package.nix · source: api.github.com
Windows
Chocolateyverified · 92%
choco install codecovChocolatey community package catalog · codecov · source: community.chocolatey.org
overview
Package summary
Codecov's command-line interface
Project links
Commands and aliases
- codecov
- codecov-cli
- codecovcli
history
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 posture
No protected-tool coverage found yet
No matching local secret-handling manifest was found for codecov-cli. Nucleus package metadata is still published here so future coverage has a stable package URL.
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
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
Config paths the tool may read or write during local use.
- Unix
codecov.yml.github/codecov.yml
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
codecov | executable | indexed executable | Discovered from the local executable index. |
codecov-cli | executable | indexed executable | Discovered from the local executable index. |
codecovcli | executable | indexed executable | Discovered from the local executable index. |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version11.3.1
manager updated2026-07-10
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:codecov-cli |
|---|---|
| Version | 11.3.1 |
| Package manager | Homebrew |
| Homepage | https://cli.codecov.io/ |
| Last updated | 2026-07-10T07:07:50Z |
| Pulse | updated |
| Bottle | not recorded |
| Service | none declared |
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Nix95%
codecov-cli
nix profile install nixpkgs#codecov-cli- normalized package name match
- Matched by: Codecov Cli
Chocolatey92%
codecov
choco install codecov- installed executable or alias match
- Matched by: Codecov
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- pkg.so package database
- pkgdb category and tag curation