Metadata-Version: 2.4
Name: cognitx-codegraph
Version: 0.1.60
Summary: Code knowledge graph for Claude Code & AI coding agents — index TypeScript, Python, NestJS, FastAPI, React into Neo4j and query architecture in Cypher. Note: v0.2.0 is deprecated, use 0.1.x.
Author-email: Leyton CognitX <cognitx@leyton.com>
License: Apache-2.0
Project-URL: Homepage, https://cognitx.leyton.com/
Project-URL: Repository, https://github.com/cognitx-leyton/graphrag-code
Project-URL: Documentation, https://github.com/cognitx-leyton/graphrag-code#readme
Project-URL: Issues, https://github.com/cognitx-leyton/graphrag-code/issues
Keywords: code-knowledge-graph,graphrag,neo4j,typescript,nestjs,react,claude-code,ai-agents,mcp,static-analysis
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: tree-sitter<0.25,>=0.23
Requires-Dist: tree-sitter-typescript>=0.23
Requires-Dist: neo4j<6,>=5.28
Requires-Dist: typer>=0.15
Requires-Dist: rich>=13
Requires-Dist: pyyaml>=6
Requires-Dist: tomli>=2.0; python_version < "3.11"
Provides-Extra: repl
Requires-Dist: prompt_toolkit>=3.0; extra == "repl"
Provides-Extra: mcp
Requires-Dist: mcp>=1.0; extra == "mcp"
Provides-Extra: python
Requires-Dist: tree-sitter-python<0.25,>=0.23; extra == "python"
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == "test"
Requires-Dist: pytest-cov>=5.0; extra == "test"

# codegraph

Map a TypeScript codebase into Neo4j with NestJS + React awareness, then query it.

## Quick start

```bash
cd codegraph

# 1. Python env
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

# 2. Neo4j
docker compose up -d
# Browser UI:  http://localhost:7475   (neo4j / codegraph123)
# Bolt:        bolt://localhost:7688

# 3. Index easy-builder
.venv/bin/python -m codegraph.cli index /home/edouard-gouilliard/easy-builder

# 4. Validate
.venv/bin/python -m codegraph.cli validate /home/edouard-gouilliard/easy-builder

# 5. Ad-hoc query
.venv/bin/python -m codegraph.cli query "MATCH (e:Endpoint) RETURN e.method, e.path LIMIT 10"
```

See `queries.md` for example queries.

## Schema

Nodes: `File`, `Class`, `Function`, `Interface`, `Endpoint`, `Hook`, `Decorator`, `External`
Edges: `IMPORTS`, `IMPORTS_EXTERNAL`, `DEFINES_CLASS`, `DEFINES_FUNC`, `DEFINES_IFACE`, `EXPOSES`, `INJECTS`, `EXTENDS`, `IMPLEMENTS`, `RENDERS`, `USES_HOOK`, `DECORATED_BY`
