diffctx — what a git change reaches, and the code to review it
diffctx tells an agent or a reviewer what a change reaches outside its diff — the callers, the tests that reach them, the contracts it crosses — and selects the code needed to understand it under a token budget. Local, deterministic, no index, no model calls. Caller resolution is static and per language; where it cannot resolve, the answer says so instead of printing a zero.
Formerly published as
treemapper— every command, flag, and API call works unchanged.
Install
# Claude Code: the MCP server, /diffctx:impact, and hooks that run it before commit and push
claude plugin marketplace add nikolay-e/diffctx
claude plugin install diffctx@diffctx
# any MCP client
claude mcp add diffctx -- uvx --from 'diffctx[mcp]' diffctx-mcp
# CLI, zero-install
uvx diffctx . --diff HEAD~1
pipx, pip, cargo, npm, Docker, Scoop, other MCP clients and the Python API: integrations.
Usage
diffctx . --diff --mode impact # uncommitted work: callers outside the diff, their tests, contracts
diffctx . --symbol parse_config # the same for a name, no change needed
diffctx . --diff main...feature # the code to review a branch, packed under the auto budget
diffctx . --diff HEAD~1 --budget 12000 # the last commit, capped at 12k o200k tokens
diffctx . --diff 24h --mode locate # today's work as ranked JSON, no source bodies
diffctx . # whole-tree export, Markdown
--diff takes a git range, staged, or a duration window ending now (24h,
90min, 2w). Every flag, default and exit code:
command-line reference.
How it compares
Whole-repo packers export everything; code-graph servers answer queries against a maintained index. diffctx is diff-seeded: the input is a change, the output is what it touches and what explains it. Measured results, and when the other two fit better: COMPARISON.md.
More
- Documentation site — the pipeline end to end
- Command-line reference — rendered from
diffctx --help - Integrations — install, MCP clients, Python API
- FAQ — heuristic or oracle, ignore rules, monorepos, secrets
- Token counting —
--budgetfor non-GPT models - GitHub Action — diff context as a CI step
- Benchmarks and the paper
- Changelog · Security
- Parameter strategy
Apache 2.0
1 maintainer
Metadata
1 maintainer
Release files for diffctx 1.18.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| diffctx-1.18.4.tar.gz | 612.4 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| diffctx-1.18.4-cp314-cp314t-win_arm64.whl | CPython 3.14 | CPython 3.14 free-threading | Windows ARM64 | Details |
| diffctx-1.18.4-cp314-cp314t-win_amd64.whl | CPython 3.14 | CPython 3.14 free-threading | Windows x86-64 | Details |
| diffctx-1.18.4-cp314-cp314t-manylinux_2_28_x86_64.whl | CPython 3.14 | CPython 3.14 free-threading | Linux glibc 2.28+ x86-64 | Details |
| diffctx-1.18.4-cp314-cp314t-manylinux_2_28_aarch64.whl | CPython 3.14 | CPython 3.14 free-threading | Linux glibc 2.28+ ARM64 | Details |
| diffctx-1.18.4-cp314-cp314t-macosx_11_0_arm64.whl | CPython 3.14 | CPython 3.14 free-threading | macOS 11.0+ ARM64 | Details |
| diffctx-1.18.4-cp314-cp314t-macosx_10_12_x86_64.whl | CPython 3.14 | CPython 3.14 free-threading | macOS 10.12+ x86-64 | Details |
| diffctx-1.18.4-cp310-abi3-win_arm64.whl | CPython 3.10 | abi3 | Windows ARM64 | Details |
| diffctx-1.18.4-cp310-abi3-win_amd64.whl | CPython 3.10 | abi3 | Windows x86-64 | Details |
| diffctx-1.18.4-cp310-abi3-manylinux_2_28_x86_64.whl | CPython 3.10 | abi3 | Linux glibc 2.28+ x86-64 | Details |
| diffctx-1.18.4-cp310-abi3-manylinux_2_28_aarch64.whl | CPython 3.10 | abi3 | Linux glibc 2.28+ ARM64 | Details |
| diffctx-1.18.4-cp310-abi3-macosx_11_0_arm64.whl | CPython 3.10 | abi3 | macOS 11.0+ ARM64 | Details |
| diffctx-1.18.4-cp310-abi3-macosx_10_12_x86_64.whl | CPython 3.10 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 117.9 MB
Release files / diffctx-1.18.4.tar.gz
| Download URL | diffctx-1.18.4.tar.gz |
|---|---|
| Size | 612.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3273880c5b6f10e5d5170efac6c77a39850fd5c90e0e5e53dfc6ff4aefc4bc2a
|
|
BLAKE2b-256 checksum How to use checksums |
5048719d44a6ac9d32b61c7681eaeb8b0bcff048ac37025c2f76a39dcf1d6ac9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / diffctx-1.18.4-cp314-cp314t-win_arm64.whl
| Download URL | diffctx-1.18.4-cp314-cp314t-win_arm64.whl |
|---|---|
| Size | 9.6 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Windows ARM64 |
|
SHA-256 checksum How to use checksums |
33e96b81d8c2ce1982980fde5980311c656056c1e5cf90137eee2f30da61639c
|
|
BLAKE2b-256 checksum How to use checksums |
c3035ea580ada4de1ea111b51b1b014467c6313a1847f63ca1e3335603a2d9f9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / diffctx-1.18.4-cp314-cp314t-win_amd64.whl
| Download URL | diffctx-1.18.4-cp314-cp314t-win_amd64.whl |
|---|---|
| Size | 9.9 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Windows x86-64 |
|
SHA-256 checksum How to use checksums |
2973a0c8b7d395a0bc9a54e0f52c10ff540e5dd38a5ab27dd364338ca98310e5
|
|
BLAKE2b-256 checksum How to use checksums |
de180025b916e0d4caadb8ce7513c40e785d054b99e77ba807365b8ea8986f3b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / diffctx-1.18.4-cp314-cp314t-manylinux_2_28_x86_64.whl
| Download URL | diffctx-1.18.4-cp314-cp314t-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 9.9 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
5111b4d87f31221aa8188125187600fdbbf9c38370c5333e3b0dd5eef37ac9b8
|
|
BLAKE2b-256 checksum How to use checksums |
433d4755285f0be78ffa82a06cecd655c2e14345a9afd180226e94bc341ba3fb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / diffctx-1.18.4-cp314-cp314t-manylinux_2_28_aarch64.whl
| Download URL | diffctx-1.18.4-cp314-cp314t-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 9.6 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
7e8a0f487afad0655c63e6895f42adf82214062e94be218197e45e9747253db3
|
|
BLAKE2b-256 checksum How to use checksums |
9ee04edcfbf6947ad199435e1ff32f5d7edbfd328fe7eaa62da92608dd9b447b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / diffctx-1.18.4-cp314-cp314t-macosx_11_0_arm64.whl
| Download URL | diffctx-1.18.4-cp314-cp314t-macosx_11_0_arm64.whl |
|---|---|
| Size | 9.9 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
79608afa1c95092db030c8d3c25da6c4ac01ea157fa050b5187892c7687db3d3
|
|
BLAKE2b-256 checksum How to use checksums |
c6429c6564e48c0dac0fdf72d3143b419e3fca0442475d83a045a4f0e7724dd0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / diffctx-1.18.4-cp314-cp314t-macosx_10_12_x86_64.whl
| Download URL | diffctx-1.18.4-cp314-cp314t-macosx_10_12_x86_64.whl |
|---|---|
| Size | 9.8 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
6b181452ce9817b15d31502bbe631a1bc19a798b0c9ac6ce69ed33624eba3d1d
|
|
BLAKE2b-256 checksum How to use checksums |
e579c05367783792a87aa02d123dff7e35ba2bbffd34e1b49463db91a5f75f69
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / diffctx-1.18.4-cp310-abi3-win_arm64.whl
| Download URL | diffctx-1.18.4-cp310-abi3-win_arm64.whl |
|---|---|
| Size | 9.6 MB |
| Tags | CPython 3.10 Windows ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
80f62e5fdf2b0bf2c8be84d57e4400842778a32ad55f90d0ff784b5c2db892b1
|
|
BLAKE2b-256 checksum How to use checksums |
48e3312bea880b85d3f37e9b4a73c90446582b635b3d708c05a262e516315228
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / diffctx-1.18.4-cp310-abi3-win_amd64.whl
| Download URL | diffctx-1.18.4-cp310-abi3-win_amd64.whl |
|---|---|
| Size | 9.9 MB |
| Tags | CPython 3.10 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
84a45e7f7ca9643c2625a80fc029e3a5d2c329dc03654246ee280f399e24af6d
|
|
BLAKE2b-256 checksum How to use checksums |
da7ab627df54c69a12192ce7a958fd65bd8c4776601a9a204fd3f8678788a0e2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / diffctx-1.18.4-cp310-abi3-manylinux_2_28_x86_64.whl
| Download URL | diffctx-1.18.4-cp310-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 9.9 MB |
| Tags | CPython 3.10 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
fe84b8dba367303e1424af4ea59f3baed621db4bd7d657aee9f2ba1b3d50863f
|
|
BLAKE2b-256 checksum How to use checksums |
30ab6588d0ea2b2cc842f96d213f177c1d2a506801f3d7197cb060ea349360fb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / diffctx-1.18.4-cp310-abi3-manylinux_2_28_aarch64.whl
| Download URL | diffctx-1.18.4-cp310-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 9.6 MB |
| Tags | CPython 3.10 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
2882a10489cb43a93df594b9ea176bb6072444866ff9e707f73a64833299285a
|
|
BLAKE2b-256 checksum How to use checksums |
5021a0077baf31211c2b806bdb2756797e6262eb49b0cfa1daf199d40a960208
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / diffctx-1.18.4-cp310-abi3-macosx_11_0_arm64.whl
| Download URL | diffctx-1.18.4-cp310-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 9.9 MB |
| Tags | CPython 3.10 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
94a3fa733fc436ffacb754d4d82f1e9d8cac93795f032136edf108bc4785a4ed
|
|
BLAKE2b-256 checksum How to use checksums |
bd69a7174bf81d65e2b38fa540d8cde29f0735410fffbbe373a175084b17a6ec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / diffctx-1.18.4-cp310-abi3-macosx_10_12_x86_64.whl
| Download URL | diffctx-1.18.4-cp310-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 9.8 MB |
| Tags | CPython 3.10 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
5d6c0952ffbff0bacbaa8d2ab8e27d08ce005f259ce0e9edcc60857447cd0b28
|
|
BLAKE2b-256 checksum How to use checksums |
fef6f7a04ed4235e9e49228c6531ba6ea9d25b1aef527787f2919c7a3bb82140
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency log
