---
id: codecov-cli
version: "11.3.1"
license: unclear
license_treatment: unclear
maintenance: active
---

# codecov-cli — Codecov Command Line Interface

License: unclear · Maintenance: active · Downloads: 1.0M/mo

## What it is and what it does

CodecovCLI is a terminal-based tool that replaces manual Codecov interactions with command-line operations. It lets you save commit metadata, create coverage reports, and upload coverage data directly from your CI pipeline or local machine. The package wraps Codecov's API behind a set of subcommands (create-commit, create-report, do-upload, and others) that can be chained together or run individually, with most parameters auto-detected from your CI environment or git metadata when available.

The tool is designed as a modern alternative to older coverage uploaders, supporting multiple git providers (GitHub, GitLab, Bitbucket, and their enterprise variants) and allowing you to customize behavior via codecov.yml configuration files. It depends on click for CLI scaffolding, requests for HTTP communication, PyYAML for config parsing, ijson for JSON streaming, sentry-sdk for error reporting, and test-results-parser for test result handling.

Use it for:

- Automate coverage uploads in CI/CD pipelines by chaining create-commit, create-report, and do-upload commands in a single workflow step.
- Manually create and manage Codecov commits and reports from your local development environment without leaving the terminal.
- Upload coverage reports from self-hosted or enterprise Codecov instances using the --enterprise-url flag.
- Integrate coverage notifications into your CI workflow using the send-notifications command after upload completion.
- Replace an older NodeJS-based uploader with a Python-native alternative in existing CI configurations.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A command-line interface for interacting with Codecov directly from your terminal or CI platform, enabling you to create commits, generate reports, and upload coverage data.

Yes, with a license caveat. The package is actively maintained, has low install friction, carries no known vulnerabilities, and is widely used (top 5000 on PyPI). However, verify the actual license terms before use in proprietary or restricted projects, since the metadata does not declare one. If you are already using Codecov and need a terminal-based uploader for CI or local workflows, this is a solid choice.

## Install

pip install codecov-cli
uv add codecov-cli
poetry add codecov-cli

## Installing codecov-cli

Before you install: Low install friction with a pure Python wheel and six runtime dependencies. The package is actively maintained with a recent release and no known vulnerabilities, though the repository has a modest star count.

License in practice: License status is unclear—no SPDX identifier or raw license text is available in the package metadata. You should verify the actual license terms before adopting it in a commercial or restricted context.

Quickstart:

pip install codecov-cli

from codecov_cli.commands.create_commit import create_commit

# Or use the CLI directly:
# codecovcli create-commit --sha <commit-sha> --token $CODECOV_TOKEN --git-service github

Requires Python 3.9 or later. A Codecov upload token (repository or global) is required for most commands.

Verify before relying:

- Whether the package is suitable for enterprise Codecov deployments (the description mentions enterprise-url support but does not detail compatibility).
- The scope and maturity of the plugin system and static analysis features mentioned as 'Work in Progress'.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

codecov coverage upload cli, command line coverage reporting, ci coverage integration tool, codecov commit and report creation, terminal-based coverage uploader, codecov ci workflow automation, coverage data management cli, ci-cd, coverage-reporting, cli-tool

[View on SkillFed](https://skillfed.io/packages/codecov-cli) · [View on PyPI](https://pypi.org/project/codecov-cli/)