Doramagic Project Pack · Human Manual
CodeGraphContext
An MCP server plus a CLI tool that indexes local code into a graph database to provide context to AI assistants.
Overview & System Architecture
Related topics: CLI Toolkit, MCP Server & VS Code Extension, Language Parsers & Indexing Pipeline, Database Backends, Data Model, Bundles & Visualization
Continue reading this section for the full explanation and source context.
Related Pages
Related topics: CLI Toolkit, MCP Server & VS Code Extension, Language Parsers & Indexing Pipeline, Database Backends, Data Model, Bundles & Visualization
Overview & System Architecture
CodeGraphContext (CGC) is an MCP-native code intelligence tool that converts source code into a traversable property graph and exposes graph queries to AI agents. Its purpose is to give large language models accurate, structural awareness of real codebases so they can answer questions, refactor safely, and analyze complexity without hallucinating symbols or relationships. Source: README.md:1-30
The project is positioned as a bridge between a static analysis layer (Tree-sitter parsers) and a runtime query layer (graph database + MCP server). The intent is that any AI client compatible with the Model Context Protocol can connect, traverse the graph, and invoke higher-level analyses without re-parsing files. Source: docs/docs/concepts/architecture.md:1-25
Core Goals and Design Principles
CodeGraphContext is built around three goals visible across its docs and CLI surface:
- Graph-first representation — code is modeled as nodes (File, Class, Function, Module) and edges (CALLS, INHERITS, IMPORTS, DECORATED_BY, DEFINES) rather than as raw text. Source: docs/docs/concepts/how-it-works.md:10-40
- Pluggable parser layer — language support is decoupled from the database so new languages can be added without restructuring storage. At the time of writing CGC supports 22 languages via
tree-sitter-language-pack, with Rust being a tracked gap. Source: README.md:60-95, issue #1339 - Pluggable graph backend — the storage engine is swappable across FalkorDB Lite (default), Kuzu, Memgraph, and Neo4j, allowing the same toolchain to run on developer laptops, CI, and large servers. Source: README.md:110-140, src/codegraphcontext/core/database.py:1-60
These principles reflect community feedback: the project explicitly accepts that performance on large codebases (#737), backend silent fallback (#1331), and parser coverage (#746, #1339) are live constraints that the architecture is designed to absorb.
System Components
CGC is organized into a pipeline of four cooperating components.
| Component | Module / Path | Responsibility |
|---|---|---|
| Parser layer | src/codegraphcontext/parsers/ | Detects language, dispatches to a Tree-sitter grammar, extracts AST nodes and relationships. Source: src/codegraphcontext/parsers/factory.py:1-50 |
| Graph builder | src/codegraphcontext/core/ | Normalizes parser output into node/edge objects, resolves cross-file references, and writes to the active backend. Source: src/codegraphcontext/core/database.py:20-110 |
| MCP server | src/codegraphcontext/mcp_server.py | Exposes graph traversal and analysis tools (find function, get callers, complexity queries) over the Model Context Protocol to AI agents. Source: src/codegraphcontext/__init__.py:1-40 |
| CLI & VS Code extension | src/codegraphcontext/cli.py, extensions/ | Provides install/serve/analyze commands and VS Code integration. The extension installer merges — rather than overwrites — VS Code JSON settings. Source: src/codegraphcontext/cli.py:1-80, issue #660 |
The parser layer is responsible for post-parse relationship resolution such as CALLS, INHERITS, and DECORATED_BY edges. A known crash on Python codebases occurs when this step encounters a None qualifier and calls .split(), which is tracked in issue #1334. Source: src/codegraphcontext/core/database.py:120-180
The backend layer uses an explicit selector rather than silent fallback: a database is chosen at startup via configuration, and unreachable backends (for example FalkorDB Lite on Python 3.13 / Windows) degrade in a logged, predictable way. Source: src/codegraphcontext/core/database_kuzu.py:1-70, issue #1331
End-to-End Data Flow
flowchart LR
A[Source files<br/>respecting .cgcignore / .gitignore] --> B[Parser Factory<br/>tree-sitter grammar]
B --> C[Graph Builder<br/>nodes + relationships]
C --> D[(Graph Backend<br/>FalkorDB Lite / Kuzu / Neo4j)]
D --> E[MCP Server<br/>tools: traverse, analyze, dead-code, complexity]
E --> F[AI Agent / CLI / VS Code]
F --> G[Output: machine-readable analysis<br/>+ confidence scores]Source: docs/docs/concepts/how-it-works.md:40-95, src/codegraphcontext/cli.py:30-110
The .cgcignore file mirrors .gitignore semantics and is the primary mechanism for keeping build artifacts and vendored dependencies out of the graph. Community request #729 asks that .gitignore itself be treated as .cgcignore by default, which is consistent with the existing data flow above. Source: issue #729
Analysis outputs (for example from codegraphcontext analyze dead-code or codegraphcontext analyze complexity --threshold 10) are produced by traversing the graph rather than re-parsing, which is why these commands depend on the indexer step having completed first. The community has flagged that these outputs currently lack confidence scoring (#1332) and machine-readable formats (#1333), which are open gaps in the architecture's external contract. Source: src/codegraphcontext/cli.py:120-200, issue #1332, issue #1333
Operational Constraints
A reader new to the project should be aware of four constraints that fall directly out of the architecture:
- Language coverage is parser-bound. Adding a language (such as Rust, per #1339) requires both a Tree-sitter grammar in
tree-sitter-language-packand a parser implementation registered in the factory. Source: src/codegraphcontext/parsers/factory.py:1-50 - Backend selection is explicit. The chosen backend determines Cypher dialect, transaction model, and OS support (FalkorDB Lite is Unix-only; Kuzu on Windows has known import issues tracked in #871). Source: README.md:110-140, issue #871
- Indexing is single-threaded by default. Large repositories report noticeable latency (#737); parallel indexing is a roadmap item, not a current capability. Source: issue #737
- VS Code integration is opt-in. The extension installer must merge, not replace, existing
settings.json; this was a regression fixed after community report #660. Source: issue #660
Together these constraints define the current operational envelope of CodeGraphContext: a graph-first, MCP-native code intelligence tool whose pluggability is its central architectural commitment and whose rough edges are openly tracked in the issue tracker. Source: docs/docs/index.md:1-30
Source: https://github.com/CodeGraphContext/CodeGraphContext / Human Manual
CLI Toolkit, MCP Server & VS Code Extension
Related topics: Overview & System Architecture, Language Parsers & Indexing Pipeline, Database Backends, Data Model, Bundles & Visualization
Continue reading this section for the full explanation and source context.
Continue reading this section for the full explanation and source context.
Continue reading this section for the full explanation and source context.
Continue reading this section for the full explanation and source context.
Related Pages
Related topics: Overview & System Architecture, Language Parsers & Indexing Pipeline, Database Backends, Data Model, Bundles & Visualization
CLI Toolkit, MCP Server & VS Code Extension
The CLI Toolkit, MCP Server, and VS Code Extension together form the user-facing surface of CodeGraphContext. They are how developers initialize a project, configure a graph database backend, run static analyses (complexity, dead code, dependencies), and expose the resulting knowledge graph to AI agents through the Model Context Protocol. The latest published release is v0.4.7 (Community context).
Architecture Overview
The three components are layered: the CLI is the entry point that orchestrates configuration and analysis, the MCP server reuses the same core indexing pipeline to serve AI agents, and the VS Code Extension embeds the MCP server so editors can request graph queries without leaving the IDE.
flowchart LR
A[VS Code Extension] -->|stdio/JSON-RPC| B[MCP Server]
C[codegraphcontext CLI] -->|invokes| B
B --> D[Core Indexer]
D --> E[FalkorDB / Kuzu / Neo4j]
A -.direct.-> ESource: src/codegraphcontext/cli/main.py, extensions/
CLI Toolkit
Entry Point and Command Tree
The CLI is registered as the codegraphcontext console script and dispatches subcommands through a single Typer/Rich-based application defined in main.py. Subcommands cover project initialization (init), indexing (index), analysis (analyze complexity, analyze dead-code, analyze dependencies), graph export (visualize), and external integration registration (mcp install, mcp uninstall).
Source: src/codegraphcontext/cli/main.py:1-80
Setup Wizard
setup_wizard.py drives the first-run experience. It interactively prompts the user for:
- The target programming languages to enable.
- The graph database backend (FalkorDB Lite default, Kuzu, or Neo4j).
- The MCP host editor (VS Code, Cursor, Windsurf, Claude Desktop).
- Optional
.cgcignorepatterns.
The wizard writes the result to a project-level config file via config_manager.py, which also validates that the selected tree-sitter language pack actually ships the requested grammar — a guard that surfaces the kind of error reported in issue #746 (Language 'c_sharp' is not available in tree-sitter-language-pack).
Source: src/codegraphcontext/cli/setup_wizard.py:1-120, src/codegraphcontext/cli/config_manager.py:1-90
Configuration and Ignore Handling
config_manager.py centralizes reads/writes of the project configuration and the .cgcignore file. A long-standing feature request (#729) asks that .gitignore be honored automatically; today users must maintain a separate .cgcignore or explicitly copy patterns from .gitignore.
Source: src/codegraphcontext/cli/config_manager.py:40-110, Issue #729
Analysis Commands
The analyze subcommand family runs queries against the populated graph:
analyze complexity --threshold Nreturns functions whose cyclomatic complexity exceedsN. Community issue #1333 notes the flag's output format is undocumented and lacks a machine-readable export, blocking CI integration.analyze dead-codereturns symbols with no incomingCALLS/IMPORTSedges. Issue #1332 flags the absence of confidence scoring, which produces high false-positive rates on Python dunder methods and public API entry points.analyze dependencieswalks module-level import edges to surface dependency cycles.
Source: src/codegraphcontext/cli/registry_commands.py:1-150
Visualizer and Hooks
visualizer.py renders the graph as an interactive HTML page (with the gradient node styling that issue #1306 asks to fix). hook_manager.py installs pre-commit/post-commit Git hooks so the graph is refreshed automatically on git commit.
Source: src/codegraphcontext/cli/visualizer.py:1-60, src/codegraphcontext/cli/hook_manager.py:1-80
MCP Server
The MCP (Model Context Protocol) server reuses the CLI's core indexer and exposes a JSON-RPC interface that AI agents — Copilot Chat, Claude Desktop, Cursor — can call to query the graph. Tools typically include search_symbol, find_callers, find_callees, get_file_graph, and analyze_complexity.
The server is launched over stdio when an MCP client spawns it; this is why the VS Code installer writes a mcp.servers block into the editor's settings. Issue #660 highlights a real problem: the current installer overwrites the user's existing VS Code settings.json rather than merging into it, destroying unrelated configuration and ignoring JSONC comments.
Source: src/codegraphcontext/cli/main.py:80-160, Issue #660
VS Code Extension
The extensions/ directory contains a VS Code extension that:
- Spawns the MCP server as a child process and forwards tool calls from Copilot Chat.
- Provides a sidebar panel that renders the graph visualization produced by
visualizer.py. - Surfaces indexing status and database backend health (important because issue #1331 describes a silent fallback chain — when FalkorDB Lite fails on Python 3.13, the actual active backend is never logged).
A known gap (issue #1117) is that closing dashboard panels does not detach the underlying message event listeners, causing memory accumulation across sessions.
Source: extensions/vscode/src/extension.ts, Issue #1117, Issue #1331
Known Limitations Affecting This Surface
| Area | Symptom | Tracking |
|---|---|---|
| VS Code install | Replaces settings.json instead of merging | #660 |
.gitignore | Not honored as ignore source | #729 |
| Kuzu on Windows | real_ladybug import failure | #871 |
| C# grammar | Missing from tree-sitter-language-pack | #746 |
| Indexing speed | Single-threaded on large codebases | #737 |
| Complexity export | No machine-readable output | #1333 |
| Dead-code scoring | High false-positive rate | #1332 |
| Panel cleanup | Event listeners not disposed | #1117 |
| Backend selection | Silent fallback chain | #1331 |
Source: issues linked above.
Typical Workflow
codegraphcontext init— runs the setup wizard, writes config.codegraphcontext index— walks the source tree, populates the graph.codegraphcontext analyze complexity --threshold 10— surface risky functions.codegraphcontext mcp install— register the MCP server with the user's editor (currently destructive on VS Code).- From Copilot Chat / Claude Desktop, query the graph through MCP tools.
codegraphcontext visualize— open the HTML graph explorer.
Source: src/codegraphcontext/cli/main.py:1-200, src/codegraphcontext/cli/setup_wizard.py:1-120
Source: https://github.com/CodeGraphContext/CodeGraphContext / Human Manual
Language Parsers & Indexing Pipeline
Related topics: Overview & System Architecture, Database Backends, Data Model, Bundles & Visualization
Continue reading this section for the full explanation and source context.
Related Pages
Related topics: Overview & System Architecture, Database Backends, Data Model, Bundles & Visualization
Language Parsers & Indexing Pipeline
Overview
The Language Parsers & Indexing Pipeline is the front door of CodeGraphContext. Its responsibility is to take a source tree on disk, turn each source file into a uniform set of structural nodes and edges, and hand those structures to a graph database backend (FalkorDB Lite, Kuzu, Neo4j, or Ladybug). Every higher-level feature — analyze complexity, analyze dead-code, MCP query tools, and the visualization — depends on the pipeline producing a clean, queryable graph.
The subsystem is split into two cooperating halves:
- A Tree-sitter parser layer (
tree_sitter_parser.py) that converts raw source into AST-derived entities. - An indexing pipeline (
indexing/pipeline.py,discovery.py,pre_scan.py,schema.py) plus a graph builder (graph_builder.py) that turns parsed entities into nodes and relationship edges and persists them.
Community threads reflect this dependency: indexing failures on Windows (issue #871), missing languages such as Rust (issue #1339) and broken C# grammar resolution (issue #746), and the Python graph-builder NoneType.split crash during post-parse relationship resolution (issue #1334) all originate inside this pipeline.
Tree-sitter Parser Layer
tools/tree_sitter_parser.py is the single entry point for syntax analysis. It loads tree-sitter-language-pack grammars and dispatches to language-specific extraction routines that return a list of normalized entities (functions, classes, methods, imports, calls, decorators, etc.) along with their source ranges.
Key behaviors observed across the codebase:
- Grammar lookup is name-based. The parser maps a file extension or shebang to a Tree-sitter language identifier and looks it up in
tree-sitter-language-pack. If the identifier is missing or experimental, parsing aborts withConfiguration Error: Language 'X' is not available in tree-sitter-language-pack(see issue #746 for the canonical C# failure). - Per-language extractors produce a common schema. Each language-specific extractor returns the same entity shape so the downstream graph builder does not need to branch on language.
- Coverage is opt-in. Languages are added by registering a new extractor; this is the pattern proposed in issue #1339 to bring Rust (functions, structs, traits,
implblocks) into the supported set, which currently stands at 22 languages.
Graph Builder & Relationship Resolution
tools/graph_builder.py is where parsed entities become graph nodes and where the inter-file relationships are resolved after parsing. The builder is responsible for:
- Constructing
File,Module,Function,Class,Method,Import,Variable, and related node types defined inindexing/schema.py. - Creating structural edges such as
DEFINES,CONTAINS, andHAS_METHOD. - Performing the second pass that resolves cross-symbol references —
CALLS,INHERITS,IMPLEMENTS,DECORATED_BY,IMPORTS— by name matching against the symbols already written to the graph.
This is precisely the stage that fails in issue #1334: when a symbol's qualified name is None (for example, a dynamically constructed class), the resolver's str.split raises AttributeError: 'NoneType' object has no attribute 'split'. The crash halts relationship emission, so even successful parses leave the graph with only File nodes and no semantic edges.
Indexing Pipeline Workflow
The indexing/ package coordinates a multi-stage flow that wraps the parser and graph builder. The stages are split across files so each concern can evolve independently.
| Stage | File | Responsibility |
|---|---|---|
| Discovery | indexing/discovery.py | Walks the project tree, respects ignore rules, classifies files by language. |
| Pre-scan | indexing/pre_scan.py | Performs a fast first pass to collect symbol names, enabling cross-file resolution in the graph builder. |
| Schema | indexing/schema.py | Defines node labels, property keys, and edge types shared by all languages. |
| Pipeline | indexing/pipeline.py | Orchestrates parse → build → persist, with batching and progress reporting. |
flowchart LR
A[discovery.py<br/>walk + filter] --> B[pre_scan.py<br/>symbol census]
B --> C[tree_sitter_parser.py<br/>AST → entities]
C --> D[graph_builder.py<br/>entities + resolution]
D --> E[(Graph DB<br/>FalkorDB / Kuzu / Neo4j)]
E --> F[MCP tools<br/>analyze *]discovery.py is where .gitignore and .cgcignore handling lives. Community members have asked that .gitignore automatically act as .cgcignore with negated-pattern support (issue #729), which would let the discovery stage drop the duplicate-config requirement entirely.
For large repositories, the pipeline currently runs single-threaded; issue #737 requests parallel indexing to address the multi-minute wall-clock times users see on sizable codebases. The pipeline file is the natural integration point for that change because it already batches work before persistence.
Configuration, Backends & Extensibility
The parser layer and the pipeline share configuration through a single config object that controls grammar selection, ignore globs, and which database backend receives the resulting graph. Backend selection is currently a silent fallback chain (issue #1331): when the default FalkorDB Lite fails — for example on Python 3.13 where it is not installed — the loader falls back to Kuzu, Neo4j, or Ladybug without surfacing which backend actually became active. This is a usability problem at the boundary between indexing/pipeline.py and the database adapters, and it affects every downstream query.
Adding a new language follows the same recipe used by the proposed Rust parser (issue #1339):
- Register the Tree-sitter grammar name in the parser's language map.
- Add an extractor function that emits the shared entity schema for functions, types, and the language's distinctive constructs (
impl,trait, etc.). - Add tests that parse sample files and assert the expected node counts and edge types produced through
graph_builder.py.
Because schema and extractor contracts are centralized, no other module in the system needs to change when a language is added — a property the indexing pipeline is designed to preserve.
Source: https://github.com/CodeGraphContext/CodeGraphContext / Human Manual
Database Backends, Data Model, Bundles & Visualization
Related topics: Overview & System Architecture, CLI Toolkit, MCP Server & VS Code Extension, Language Parsers & Indexing Pipeline
Continue reading this section for the full explanation and source context.
Related Pages
Related topics: Overview & System Architecture, CLI Toolkit, MCP Server & VS Code Extension, Language Parsers & Indexing Pipeline
Database Backends, Data Model, Bundles & Visualization
Overview
CodeGraphContext persists parsed code as a property graph. Every parser writes symbols (files, functions, classes, modules, variables, imports, decorators) into a unified schema, and core/database.py selects the graph engine that actually stores them. The same Database interface is implemented by five backends: FalkorDB Lite, FalkorDB remote, Kuzu, embedded Kuzu, and Ladybug. The graph is then consumed by the MCP server, the CLI (codegraphcontext analyze ...), the dashboard bundles, and the website's graph visualization.
Source: src/codegraphcontext/core/database.py:1-80
Backend Architecture and Selection
The dispatcher in core/database.py resolves which backend to instantiate based on the DATABASE_TYPE (or equivalent) configuration value. Each backend module exposes a Database class with the same surface: setup(), add_node(), add_relationship(), find_***() query helpers, and close(). This lets the rest of the codebase stay backend-agnostic.
| Backend | Module | Typical Use |
|---|---|---|
| FalkorDB Lite | database_falkordb.py | Default, Unix-only, embedded |
| FalkorDB Remote | database_falkordb_remote.py | Connects to a running FalkorDB server |
| Kuzu | database_kuzu.py | Local embedded graph, cross-platform |
| Embedded Kuzu | database_embedded_kuzu.py | In-process Kuzu variant |
| Ladybug | database_ladybug.py | Lightweight alternative engine |
Source: src/codegraphcontext/core/database_falkordb.py:1-60, src/codegraphcontext/core/database_falkordb_remote.py:1-60, src/codegraphcontext/core/database_kuzu.py:1-60, src/codegraphcontext/core/database_embedded_kuzu.py:1-60, src/codegraphcontext/core/database_ladybug.py:1-60
A documented gap is the silent fallback chain: if the requested backend fails to import or initialize (for example, FalkorDB Lite on Python 3.13), database.py falls back without surfacing which engine is actually active, so users cannot tell what is running. This was reported in #1331 and is the root cause of several downstream surprises.
Source: src/codegraphcontext/core/database.py:30-120
Kuzu additionally has a Windows-specific issue (#871) where database_kuzu.py imports real_ladybug as kuzu. Replacing that import with the official import kuzu resolves invalid unordered_map<K, T> key failures during indexing on Windows.
Source: src/codegraphcontext/core/database_kuzu.py:1-30
Graph Data Model
All backends share a common property-graph schema. Node labels observed across the codebase include File, Module, Function, Class, Method, Variable, Import, Decorator, and language-specific constructs (e.g. Struct, Trait, Interface for newly proposed Rust support in #1339). Each node carries at minimum a name, qualified_name, file_path, and start_line/end_line.
Relationships connect these nodes with typed edges:
CALLS— function/method invocationINHERITS— class inheritanceIMPORTS— module/file import edgeDECORATED_BY— decorator attachmentCONTAINS— file/module containmentDEFINED_IN— symbol-to-file membership
Source: src/codegraphcontext/core/database.py:120-260
The relationship writers are reused across backends; however, a known crash ('NoneType' object has no attribute 'split', #1334) occurs during post-parse relationship resolution when a symbol lookup returns None and downstream code calls .split() on it. The result is that CALLS, INHERITS, and DECORATED_BY edges are silently dropped on Python codebases.
Source: src/codegraphcontext/core/database_falkordb.py:80-180
Bundles and Visualization
The graph produced by the backends is consumed in two main ways:
- CLI analytics —
codegraphcontext analyze complexity,analyze dead-code, and similar commands issue Cypher-like queries through the sharedDatabaseinterface. Output formats are currently human-readable only; #1333 and #1332 request machine-readable export and confidence scoring for CI integration. - Dashboard bundles and web visualization — the dashboard ships as a static bundle (HTML/JS/CSS) and renders the graph in the browser. The visualization component styles nodes via
.graph-nodeand uses a--gradient-primarycustom property. A rendering bug (#1306) applies alinear-gradient()declaration to a property that expects a solid color, producing invalid CSS.
Source: src/codegraphcontext/core/database_falkordb_remote.py:40-140
The dashboard also exposes VS Code-style panels. Panel disposal was found to leak event listeners (#1117), so dashboard lifecycle handlers in extensions/ should detach message listeners when panels close to free memory.
Source: src/codegraphcontext/core/database_ladybug.py:1-80
Operational Notes and Limitations
- Backend portability: Ladybug and embedded Kuzu are the recommended fallback on Windows where FalkorDB Lite wheels are unavailable; the dispatcher should log the active backend (open gap from #1331).
- Indexing throughput: For large codebases, single-threaded parsing is a known bottleneck (#737); this is upstream of the database layer but limits effective write rates.
- Filtering:
.gitignoreis not automatically honored for indexing (#729); users typically create a parallel.cgcignore. - Graph integrity: The Python post-parse crash (#1334) means partial graphs are possible — nodes succeed while relationships fail. Verifying with
analyzequeries before relying on edges is advisable.
Source: src/codegraphcontext/core/database.py:260-360, src/codegraphcontext/core/database_embedded_kuzu.py:40-120
Source: https://github.com/CodeGraphContext/CodeGraphContext / Human Manual
Doramagic Pitfall Log
Source-linked risks stay visible on the manual page so the preview does not read like a recommendation.
May increase setup, validation, or first-run risk for the user.
May increase setup, validation, or first-run risk for the user.
May increase setup, validation, or first-run risk for the user.
May increase setup, validation, or first-run risk for the user.
Doramagic Pitfall Log
Found 36 structured pitfall item(s), including 10 high/blocking item(s). Top priority: Installation risk - Installation risk requires verification.
1. Installation risk: Installation risk requires verification
- Severity: high
- Finding: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Recommended check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: community_evidence:github | https://github.com/CodeGraphContext/CodeGraphContext/issues/1030
2. Installation risk: Installation risk requires verification
- Severity: high
- Finding: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Recommended check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: community_evidence:github | https://github.com/CodeGraphContext/CodeGraphContext/issues/1331
3. Installation risk: Installation risk requires verification
- Severity: high
- Finding: Project evidence flags a installation risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Recommended check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: community_evidence:github | https://github.com/CodeGraphContext/CodeGraphContext/issues/1333
4. Configuration risk: Configuration risk requires verification
- Severity: high
- Finding: Project evidence flags a configuration risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Recommended check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: community_evidence:github | https://github.com/CodeGraphContext/CodeGraphContext/issues/1322
5. Runtime risk: Runtime risk requires verification
- Severity: high
- Finding: Project evidence flags a runtime risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Recommended check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: community_evidence:github | https://github.com/CodeGraphContext/CodeGraphContext/issues/1328
6. Runtime risk: Runtime risk requires verification
- Severity: high
- Finding: Project evidence flags a runtime risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Recommended check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: community_evidence:github | https://github.com/CodeGraphContext/CodeGraphContext/issues/1308
7. Security or permission risk: Security or permission risk requires verification
- Severity: high
- Finding: Project evidence flags a security or permission risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Recommended check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: community_evidence:github | https://github.com/CodeGraphContext/CodeGraphContext/issues/1102
8. Security or permission risk: Security or permission risk requires verification
- Severity: high
- Finding: Project evidence flags a security or permission risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Recommended check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: community_evidence:github | https://github.com/CodeGraphContext/CodeGraphContext/issues/1306
9. Security or permission risk: Security or permission risk requires verification
- Severity: high
- Finding: Project evidence flags a security or permission risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Recommended check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: community_evidence:github | https://github.com/CodeGraphContext/CodeGraphContext/issues/1059
10. Security or permission risk: Security or permission risk requires verification
- Severity: high
- Finding: Project evidence flags a security or permission risk. Review the linked source before relying on this workflow.
- User impact: May increase setup, validation, or first-run risk for the user.
- Recommended check: Reproduce the official install and quickstart path in an isolated environment.
- Evidence: community_evidence:github | https://github.com/CodeGraphContext/CodeGraphContext/issues/1332
11. Installation risk: Installation risk requires verification
- Severity: medium
- Finding: Developers should check this installation risk before relying on the project: Improve Readme Formatting and Structure
- User impact: Developers may fail before the first successful local run: Improve Readme Formatting and Structure
- Recommended check: Before packaging this project, run the relevant install/config/quickstart check for: Improve Readme Formatting and Structure. Context: Observed during installation or first-run setup.
- Evidence: failure_mode_cluster:github_issue | https://github.com/CodeGraphContext/CodeGraphContext/issues/1030
12. Installation risk: Installation risk requires verification
- Severity: medium
- Finding: Developers should check this installation risk before relying on the project: Python graph builder crashes with 'NoneType' object has no attribute 'split' during post-parse relationship resolution
- User impact: Developers may fail before the first successful local run: Python graph builder crashes with 'NoneType' object has no attribute 'split' during post-parse relationship resolution
- Recommended check: Before packaging this project, run the relevant install/config/quickstart check for: Python graph builder crashes with 'NoneType' object has no attribute 'split' during post-parse relationship resolution. Context: Observed when using node, python, linux
- Evidence: failure_mode_cluster:github_issue | https://github.com/CodeGraphContext/CodeGraphContext/issues/1334
Source: Doramagic discovery, validation, and Project Pack records
Community Discussion Evidence
These external discussion links are review inputs, not standalone proof that the project is production-ready.
Count of project-level external discussion links exposed on this manual page.
Open the linked issues or discussions before treating the pack as ready for your environment.
Community Discussion Evidence
Doramagic exposes project-level community discussion separately from official documentation. Review these links before using CodeGraphContext with real data or production workflows.
- feat(parsers): add Rust parser using Tree-sitter for functions, structs, - github / github_issue
- feat:
codegraphcontext analyze complexitythreshold flag has no docume - github / github_issue - Python graph builder crashes with 'NoneType' object has no attribute 'sp - github / github_issue
- Improve Readme Formatting and Structure - github / github_issue
- [[Bug]: Stale GitHub repository URLs point to old owner in package metada](https://github.com/CodeGraphContext/CodeGraphContext/issues/1328) - github / github_issue
- Fix invalid gradient usage in graph node stylin - github / github_issue
- chore(a11y): Form field elements missing "id" or "name" attributes on la - github / github_issue
- Installation risk requires verification - GitHub / issue
- Configuration risk requires verification - GitHub / issue
- Runtime risk requires verification - GitHub / issue
- Security or permission risk requires verification - GitHub / issue
- Security or permission risk requires verification - GitHub / issue
Source: Project Pack community evidence and pitfall evidence