Graph traversal and context queries over grounded-index metadata
Project description
grounded-graph
Graph traversal and context queries over code metadata. grounded-graph reads a
grounded-index SQLite database
and exposes call graphs, impact analysis, test discovery, and token-bounded
context packs for AI coding agents.
Two storage backends:
- Pure-Python (
--backend python) — fast in-memory, no extra dependencies. - sqlitegraph (
--backend sqlitegraph) — file-backed Rust graph with HNSW semantic search and persistent indexes.
Quick start
# 1. Index your project (produces .grounded-index.db)
grounded-index index .
# 2. Load the graph and check stats
grounded-graph index --backend python
# 3. Query
grounded-graph callers --symbol my_function
grounded-graph tests-for --symbol CustomerService
grounded-graph neighborhood --symbol my_function --depth 2 --budget 4000
What it does
| Capability | Description |
|---|---|
| Call graph | callers, callees, impact, affected with kind-filtered traversal |
| Test mapping | tests-for links tests to the symbols they exercise |
| Shortest path | path --from A --to B between any two symbols |
| Context packs | neighborhood returns priority-ranked, token-bounded symbol context |
| Semantic search | HNSW-backed similarity search over symbol embeddings (sqlitegraph only) |
| Multi-kind edges | Same node pair can carry call, defines, imports, and tests edges |
See MANUAL.md for full CLI documentation and API.md for the Python API.
Install
pip install grounded-graph
Requires Python >= 3.10.
Version
Current version: 0.4.1
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file grounded_graph-0.4.1.tar.gz.
File metadata
- Download URL: grounded_graph-0.4.1.tar.gz
- Upload date:
- Size: 44.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
825d6e94612b50fcc84344c112394d65c8f896a8a0e5a1a73772b082371f68fc
|
|
| MD5 |
6df8c5ff7262dff000d64a9d89e77833
|
|
| BLAKE2b-256 |
b04a2695337fb4fdbce90cfa1d5c3ee0e9f01dde574021dee4fb299ea4a9daad
|
File details
Details for the file grounded_graph-0.4.1-py3-none-any.whl.
File metadata
- Download URL: grounded_graph-0.4.1-py3-none-any.whl
- Upload date:
- Size: 22.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
81c08d69465fd47499fc83c62cf6ca6171bca87de5d35b3f0d92ace67010e66d
|
|
| MD5 |
5951bec7833f1ea0a7176dd83d6c1e65
|
|
| BLAKE2b-256 |
4fabac4b1940f81c66fe7f9f81dfb810214628befb18969c06cbab592b4f6593
|
