codingest

Give AI agents a live, queryable map of any codebase — locally, privately, and without running the code you are analysing.

codingest turns polyglot source into a KGLite knowledge graph of functions, types, calls, imports, inheritance, routes, documentation, and git revisions. Use it from Python, the command line, or as an MCP server for coding agents.

pip install codingest

import codingest

graph = codingest.build(".")
graph.cypher("MATCH (f:Function) RETURN f.name LIMIT 10")

No language servers, databases, or repository-specific build steps are required. The native Rust builder bundles parsers for 15 languages and returns a real kglite.KnowledgeGraph, ready for Cypher queries.

Built for agents and code analysis

Agent-ready MCP: give an MCP client graph_overview, cypher_query, read_code_source, repository switching, and automatic graph refresh.
Fast local review: map definitions, callers, dependencies, routes, inheritance, and affected tests without uploading or executing the project.
Open-source intelligence: clone and analyse a GitHub repository with one Python call, or let an agent manage cached public repositories through MCP.
Polyglot by default: one graph across Python, Rust, TypeScript, JavaScript, Java, Go, C/C++, C#, Swift, PHP, HTML, CSS, Dart, and AGC assembly.
Revision-aware: analyse a tag, branch, commit, or multiple revisions in one graph and query what changed.

AGC assembly receives architecture-aware control and data relationships rather than a generic text-level call graph; see the AGC graph model.

Give your agent a code-review MCP server

pip install codingest
codingest-mcp --watch /absolute/path/to/repo

Point an MCP client at the same command:

{
  "mcpServers": {
    "code-review": {
      "command": "codingest-mcp",
      "args": ["--watch", "/absolute/path/to/repo"]
    }
  }
}

The server builds the graph at startup, refreshes it when source files change, and gives the agent schema discovery, Cypher, and source-reading tools over stdio. For a multi-repository agent sandbox with runtime set_root_dir, use the local-workspace manifest described in the MCP guide.

For a zero-configuration CLI workflow, install the packaged code-review Agent Skill instead:

pip install codingest
codingest skill install

The skill teaches compatible agents to build a fresh graph, discover its schema before querying, combine Cypher with the git diff, and verify findings against source lines. See the MCP guide and CLI guide.

Analyse a local codebase

import codingest

graph = codingest.build(
    ".",
    include_docs=True,
)

rows = graph.cypher("""
MATCH (caller:Function)-[:CALLS]->(target:Function)
RETURN target.qualified_name, count(caller) AS callers
ORDER BY callers DESC
LIMIT 10
""")

codingest.build(".", save_to="code-review.kgl")

The bundled terminal command offers the same workflow:

codingest build /path/to/repo
codingest status --output /path/to/repo/.kglite/code-review.kgl
kglite describe /path/to/repo/.kglite/code-review.kgl --connections

Analyse an open-source repository

import codingest

graph = codingest.repo_tree("pallets/flask")
graph.cypher("""
MATCH (route:Function)-[:CALLS]->(dependency:Function)
RETURN route.qualified_name, dependency.qualified_name
LIMIT 25
""")

repo_tree() shallow-clones the requested repository into a temporary directory, builds the graph, and cleans up afterward. Pass branch=, clone_to=, or token= for a specific revision, a reusable cache, or a private repository.

Compare revisions

graph = codingest.build(".", revs=["v1.0", "v2.0"])
graph.cypher("""
MATCH (f:Function)
WHERE 'v2.0' IN f.revs AND NOT 'v1.0' IN f.revs
RETURN f.qualified_name
""")

Revision builds use tracked git content without changing the working tree. Multi-revision graphs store shared entities once and expose revision membership for direct Cypher analysis.

Install options

pip install codingest          # Python API + CLI + MCP server + KGLite runtime
codingest skill install        # code-review Agent Skill

The wheel bundles every grammar plus the codingest and codingest-mcp commands. KGLite ≥0.14.5 is installed automatically as the query/storage engine; its MCP server and the transitive mcp-methods framework power the builder-aware Codingest server. Nothing else needs to be installed.

Rust-only environments can instead use cargo install codingest-cli codingest-mcp; these are alternative distributions of the same commands, not Python prerequisites.

Rust crate

[dependencies]
codingest = "0.1"
kglite = "0.14.5"

use codingest::build_code_tree;

let graph = build_code_tree(
    dir,
    false, // verbose
    true,  // include tests
    None,  // save path
    None,  // max lines per file
    false, // include docs
)?;

How it fits together

codingest owns code-graph construction, the Python/CLI interfaces, the builder-backed MCP executable, and the code-review Agent Skill. KGLite provides the graph engine, Cypher, persistence, and reusable query/read tools. Keeping that boundary explicit lets codingest focus on accurate code understanding while reusing a dedicated graph engine.

Documentation: codingest.readthedocs.io

Workspace layout

Crate	What it is
`crates/codingest`	The component library (`codingest`): builder, parsers, manifest reader, docs pass, multi-rev merge, cross-language edges. Extracted from the former `KGLite/crates/kglite/src/code_tree/` (removed upstream 2026-07-16) and re-targeted at the public `kglite::api` facade. Ships the `codingest_stats` + `codingest_bench` binaries.
`crates/codingest-cli`	`codingest` binary — `build` a checkout or git revision(s) into a `.kgl` graph, `status` to check staleness, and `skill` to install Codingest's code-review Agent Skill.
`crates/codingest-mcp`	`codingest-mcp` binary — the full MCP tool surface imported from the `kglite-mcp-server` library, with the codingest builder injected.
`crates/codingest-py`	PyO3 wrapper built by maturin into the `codingest` wheel (`pip install codingest`). Python package source is `codingest/`; `pyproject.toml` drives the maturin build. Not published to crates.io (`publish = false`).

CI-equivalent local gate

cargo build --workspace
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
cargo test -p codingest --test parity

The golden-digest oracle

KGLite deleted its in-tree code_tree builder on 2026-07-16, so the old two-builder parity sweep is gone. The authority it enforced was frozen while the builders were still verified identical, into per-corpus SHA-256 digests under crates/codingest/tests/goldens/ (committed fixtures — no network). The golden_parity test builds each corpus with only the codingest builder, digests a canonical exhaustive graph rendering, and compares to the frozen golden. The multi-rev fixture is guarded instead by rev_self_consistency. Regenerate goldens only for deliberate builder-behavior changes: cargo test -p codingest --test parity -- --ignored capture_goldens (details in crates/codingest/tests/goldens/README.md).

Dependency policy

kglite and kglite-mcp-server use matching crates.io requirements with a 0.14.5 minimum and a shared lockfile. This keeps the builder, persistence handoff, and embedded MCP server on one compatible engine patch line.

Parity with the (now-removed) in-tree component

codingest was extracted to be feature- and performance-identical to kglite's in-tree code_tree. KGLite removed that module on 2026-07-16, so parity is now enforced against a frozen record of its last-known-good output rather than live cross-comparison. See PARITY.md (stats-diff + timing), BENCHMARKS.md (build-time + Cypher benchmarks), crates/codingest/tests/parity.rs (the golden oracle), and docs/mcp-parity.md (the MCP↔builder coupling and the hook).

tests/python-legacy/ preserves KGLite's full 47-file kglite.code_tree behavioral suite verbatim as the dormant behavioral spec — the source of truth for what the Python builder guaranteed (see its README).

License

MIT © Kristian dF Kollsgård. codingest is an independent project; it depends on kglite at runtime but is not otherwise affiliated with it.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

codingest-0.1.3.tar.gz (274.9 kB view details)

Uploaded Jul 22, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

codingest-0.1.3-cp310-abi3-win_amd64.whl (11.0 MB view details)

Uploaded Jul 22, 2026 CPython 3.10+Windows x86-64

codingest-0.1.3-cp310-abi3-manylinux_2_28_aarch64.whl (10.2 MB view details)

Uploaded Jul 22, 2026 CPython 3.10+manylinux: glibc 2.28+ ARM64

codingest-0.1.3-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (10.9 MB view details)

Uploaded Jul 22, 2026 CPython 3.10+manylinux: glibc 2.17+ x86-64

codingest-0.1.3-cp310-abi3-macosx_11_0_arm64.whl (10.0 MB view details)

Uploaded Jul 22, 2026 CPython 3.10+macOS 11.0+ ARM64

codingest-0.1.3-cp310-abi3-macosx_10_12_x86_64.whl (10.5 MB view details)

Uploaded Jul 22, 2026 CPython 3.10+macOS 10.12+ x86-64

File details

Details for the file codingest-0.1.3.tar.gz.

File metadata

Download URL: codingest-0.1.3.tar.gz
Upload date: Jul 22, 2026
Size: 274.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for codingest-0.1.3.tar.gz
Algorithm	Hash digest
SHA256	`7e11b6c4ad771555d99be5c7e1cf7b2bf6d3799c755b996ee02e131c8a1ffd25`
MD5	`a1a8e706aa6d2fab1af9e372d60ce1c8`
BLAKE2b-256	`67646843b48c0fdbb0507a9d56b33da82594e4cb567819b6a9cc44f1c2625bb9`

See more details on using hashes here.

Provenance

The following attestation bundles were made for codingest-0.1.3.tar.gz:

Publisher: release.yml on kkollsga/codingest

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: codingest-0.1.3.tar.gz
- Subject digest: 7e11b6c4ad771555d99be5c7e1cf7b2bf6d3799c755b996ee02e131c8a1ffd25
- Sigstore transparency entry: 2217568242
- Sigstore integration time: Jul 22, 2026
Source repository:
- Permalink: kkollsga/codingest@d64d7a23acb3b8bd104f5a0531b908b6d9122e69
- Branch / Tag: refs/tags/v0.1.3
- Owner: https://github.com/kkollsga
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@d64d7a23acb3b8bd104f5a0531b908b6d9122e69
- Trigger Event: push

File details

Details for the file codingest-0.1.3-cp310-abi3-win_amd64.whl.

File metadata

Download URL: codingest-0.1.3-cp310-abi3-win_amd64.whl
Upload date: Jul 22, 2026
Size: 11.0 MB
Tags: CPython 3.10+, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for codingest-0.1.3-cp310-abi3-win_amd64.whl
Algorithm	Hash digest
SHA256	`a23e9b4b0527260d7c39df789cb214b4d5b2712f56d895855e18f08644684246`
MD5	`2e4063896d1f0f466e9dd0394cf73344`
BLAKE2b-256	`6ec8ae634f0b16875a71b2db5ae8875e80f84cc29a4c38e44ffab5eac5e0bbd3`

See more details on using hashes here.

Provenance

The following attestation bundles were made for codingest-0.1.3-cp310-abi3-win_amd64.whl:

Publisher: release.yml on kkollsga/codingest

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: codingest-0.1.3-cp310-abi3-win_amd64.whl
- Subject digest: a23e9b4b0527260d7c39df789cb214b4d5b2712f56d895855e18f08644684246
- Sigstore transparency entry: 2217568349
- Sigstore integration time: Jul 22, 2026
Source repository:
- Permalink: kkollsga/codingest@d64d7a23acb3b8bd104f5a0531b908b6d9122e69
- Branch / Tag: refs/tags/v0.1.3
- Owner: https://github.com/kkollsga
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@d64d7a23acb3b8bd104f5a0531b908b6d9122e69
- Trigger Event: push

File details

Details for the file codingest-0.1.3-cp310-abi3-manylinux_2_28_aarch64.whl.

File metadata

Download URL: codingest-0.1.3-cp310-abi3-manylinux_2_28_aarch64.whl
Upload date: Jul 22, 2026
Size: 10.2 MB
Tags: CPython 3.10+, manylinux: glibc 2.28+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for codingest-0.1.3-cp310-abi3-manylinux_2_28_aarch64.whl
Algorithm	Hash digest
SHA256	`db99a58c6e1a874013c470144f4863608786704283733d8c6f29dea53c2e4b8a`
MD5	`d8fc64d746eb8d6bdf2faa5dbe00369c`
BLAKE2b-256	`4f9d743afb806b1b3895c9303ccb681282fd1f7b00eb6fc1a32766213567471c`

See more details on using hashes here.

Provenance

The following attestation bundles were made for codingest-0.1.3-cp310-abi3-manylinux_2_28_aarch64.whl:

Publisher: release.yml on kkollsga/codingest

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: codingest-0.1.3-cp310-abi3-manylinux_2_28_aarch64.whl
- Subject digest: db99a58c6e1a874013c470144f4863608786704283733d8c6f29dea53c2e4b8a
- Sigstore transparency entry: 2217568379
- Sigstore integration time: Jul 22, 2026
Source repository:
- Permalink: kkollsga/codingest@d64d7a23acb3b8bd104f5a0531b908b6d9122e69
- Branch / Tag: refs/tags/v0.1.3
- Owner: https://github.com/kkollsga
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@d64d7a23acb3b8bd104f5a0531b908b6d9122e69
- Trigger Event: push

File details

Details for the file codingest-0.1.3-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

Download URL: codingest-0.1.3-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Upload date: Jul 22, 2026
Size: 10.9 MB
Tags: CPython 3.10+, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for codingest-0.1.3-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`a31909250526b3a37cd26b67598028af4e948e98c2b6b599ec4b0553c3afef3f`
MD5	`c4806de07440eb2659fbffeacfa128f6`
BLAKE2b-256	`281901a4e915e739a4c8ae406d06cd51c1b917e7e71d7260cebc5ed6472fa619`

See more details on using hashes here.

Provenance

The following attestation bundles were made for codingest-0.1.3-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on kkollsga/codingest

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: codingest-0.1.3-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Subject digest: a31909250526b3a37cd26b67598028af4e948e98c2b6b599ec4b0553c3afef3f
- Sigstore transparency entry: 2217568312
- Sigstore integration time: Jul 22, 2026
Source repository:
- Permalink: kkollsga/codingest@d64d7a23acb3b8bd104f5a0531b908b6d9122e69
- Branch / Tag: refs/tags/v0.1.3
- Owner: https://github.com/kkollsga
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@d64d7a23acb3b8bd104f5a0531b908b6d9122e69
- Trigger Event: push

File details

Details for the file codingest-0.1.3-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

Download URL: codingest-0.1.3-cp310-abi3-macosx_11_0_arm64.whl
Upload date: Jul 22, 2026
Size: 10.0 MB
Tags: CPython 3.10+, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for codingest-0.1.3-cp310-abi3-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`a0a43c630b7370d8db56a7bb7d021e961e5a9ad12b8be776e7ccbec554e929ac`
MD5	`e44463568a23857c1b176f02c327fcfe`
BLAKE2b-256	`75d70768afc92f4b2f8211c490242e231bae5cfdf55b02c5d2800bbbb74a8a0d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for codingest-0.1.3-cp310-abi3-macosx_11_0_arm64.whl:

Publisher: release.yml on kkollsga/codingest

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: codingest-0.1.3-cp310-abi3-macosx_11_0_arm64.whl
- Subject digest: a0a43c630b7370d8db56a7bb7d021e961e5a9ad12b8be776e7ccbec554e929ac
- Sigstore transparency entry: 2217568268
- Sigstore integration time: Jul 22, 2026
Source repository:
- Permalink: kkollsga/codingest@d64d7a23acb3b8bd104f5a0531b908b6d9122e69
- Branch / Tag: refs/tags/v0.1.3
- Owner: https://github.com/kkollsga
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@d64d7a23acb3b8bd104f5a0531b908b6d9122e69
- Trigger Event: push

File details

Details for the file codingest-0.1.3-cp310-abi3-macosx_10_12_x86_64.whl.

File metadata

Download URL: codingest-0.1.3-cp310-abi3-macosx_10_12_x86_64.whl
Upload date: Jul 22, 2026
Size: 10.5 MB
Tags: CPython 3.10+, macOS 10.12+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for codingest-0.1.3-cp310-abi3-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`3943014f435a36a59d64a51e7635bb6313d497b7d21a9a23cb3139d28caf6230`
MD5	`e4932d4718e4161906d37389704d1139`
BLAKE2b-256	`0b5fe2f482ef144b44a6980a5ab0b4556e62d79c6377c0d4ece2e144d7fa9c4d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for codingest-0.1.3-cp310-abi3-macosx_10_12_x86_64.whl:

Publisher: release.yml on kkollsga/codingest

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: codingest-0.1.3-cp310-abi3-macosx_10_12_x86_64.whl
- Subject digest: 3943014f435a36a59d64a51e7635bb6313d497b7d21a9a23cb3139d28caf6230
- Sigstore transparency entry: 2217568365
- Sigstore integration time: Jul 22, 2026
Source repository:
- Permalink: kkollsga/codingest@d64d7a23acb3b8bd104f5a0531b908b6d9122e69
- Branch / Tag: refs/tags/v0.1.3
- Owner: https://github.com/kkollsga
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@d64d7a23acb3b8bd104f5a0531b908b6d9122e69
- Trigger Event: push

Release history Release notifications | RSS feed

0.2.2

Aug 12, 2026

0.2.1

Aug 12, 2026

0.2.0

Aug 11, 2026

0.1.7

Aug 6, 2026

0.1.6

Aug 1, 2026

0.1.5

Aug 1, 2026

0.1.4

Jul 30, 2026

This release

0.1.3

Jul 22, 2026

0.1.2

Jul 22, 2026

0.1.1

Jul 21, 2026

0.1.0

Jul 16, 2026

codingest 0.1.3

codingest

Built for agents and code analysis

Give your agent a code-review MCP server

Analyse a local codebase

Analyse an open-source repository

Compare revisions

Install options

Rust crate

How it fits together

Workspace layout

CI-equivalent local gate

The golden-digest oracle

Dependency policy

Parity with the (now-removed) in-tree component

License

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License expression

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed