codegraphcontext
- Repo stars 3,585
- Author repo CodeGraphContext
CodeGraphContext (CGC)
When to use this skill
- Indexing or re-indexing a codebase for AI or CLI queries.
- Explaining how to install and run
cgc, choose a database backend, or wire MCP into an editor. - Interpreting CGC tools:
codegraph_find_code,analyze_code_relationships,add_code_to_graph, etc.
Core workflow
- Install:
pip install codegraphcontext(orpipx install codegraphcontext). With uv,uv tool install codegraphcontextoruvx codegraphcontext …is supported; if a parser fails withModuleNotFoundError: tree_sitter_c_sharp, run with an explicit extra package, e.g.uvx --with tree-sitter-c-sharp codegraphcontext …. - Configure: Optional
~/.codegraphcontext/.envforDEFAULT_DATABASE, Neo4j URI, or Kùzu path. Runcgc doctorif connections fail. - Index: From the repo root,
cgc index .(orcgc index --force .to rebuild). Ensure CLI and MCP use the same config so they see the same graph. - Query: CLI (
cgc find,cgc query, …) or MCP tools aftercgc mcp setup/cgc mcp startin the client config.
MCP setup (short)
- Run
cgc mcp setupand pick the editor, or add a server entry that runscgcwith argsmcpstartand the same env as the CLI. - OpenCode: Follow the vendor MCP docs for registering a stdio server, then point the command at
cgcwith argumentsmcp,start(same as other editors). Official OpenCode MCP overview: OpenCode MCP servers.
Agent behavior
- Prefer indexing the workspace before deep graph queries if the user has not indexed yet.
- For fuzzy symbol search on Kùzu/Falkor backends, matching is typo-tolerant (edit distance); on Neo4j, full-text fuzzy uses Lucene-style terms—preserve original casing in queries when fuzziness matters for camelCase symbols.
- If
Repository.pathis missing in the DB, that row is skipped for path checks and a warning is logged when repositories are listed; suggest cleaning staleRepositorynodes (see Neo4j example in logs) if it keeps happening.
References in this repo
- CLI entry:
codegraphcontext.cli.main - MCP server and tool wiring:
codegraphcontext.server,tool_definitions.py - User-facing setup detail:
docs/docs/setup_workflows.md,docs/docs/guides/mcp_guide.md - Published copy of this skill (for docs / GitHub):
docs/docs/agent_skill_codegraphcontext.md
- Fluxly category
- Other
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Author / version / license
- @CodeGraphContext · no license declared
- Fluxly token estimate
- Lean
- Fluxly setup estimate
- Plug-and-play
- External API key
- No requirement detected
- Detected OS requirements
- Unspecified
- Runtime requirements
- Unspecified
- Detected file/system behavior
-
- Read-only
- Write / modify
- Env read
- Detected network behavior
- Local-only
- Install commands
- None (reference only)
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
The current SKILL.md does not define a fixed output example. Indexing or re-indexing a codebase for AI or CLI queries. Explaining how to install and run cgc, choose a database backend, or wire MCP into an editor. Interpreting CGC tools: codegraphfindcode, analyzecoderelationships, addcodetograph, etc.
Install: pip install codegraphcontext (or pipx install codegraphcontext). With uv, uv tool install codegraphcontext or uvx codegraphcontext … is supported; if a parser fails with ModuleNotFoundError: treesittercsharp, run with an explicit extra package, e.g.…
Run cgc mcp setup and pick the editor, or add a server entry that runs cgc with args mcp start and the same env as the CLI. OpenCode: Follow the vendor MCP docs for registering a stdio server, then point the command at cgc with arguments mcp, start (same as…
Prefer indexing the workspace before deep graph queries if the user has not indexed yet. For fuzzy symbol search on Kùzu/Falkor backends, matching is typo-tolerant (edit distance); on Neo4j, full-text fuzzy uses Lucene-style terms—preserve original casing in…
CLI entry: codegraphcontext.cli.main MCP server and tool wiring: codegraphcontext.server, tooldefinitions.py User-facing setup detail: docs/docs/setupworkflows.md, docs/docs/guides/mcpguide.md
# CodeGraphContext (CGC)
## When to use this skill
- Indexing or re-indexing a codebase for AI or CLI queries.
- Explaining how to install and run `cgc`, choose a database backend, or wire MCP into an editor.
- Interpreting CGC tools: `codegraph_find_code`, `analyze_code_relationships`, `add_code_to_graph`, etc.
## Core workflow
1. **Install**: `pip install codegraphcontext` (or `pipx install codegraphcontext`). With **uv**, `uv tool install codegraphcontext` or `uvx codegraphcontext …` is supported; if a parser fails with `ModuleNotFoundError: tree_sitter_c_sharp`, run with an explicit extra package, e.g. `uvx --with tree-sitter-c-sharp codegraphcontext …`.
2. **Configure**: Optional `~/.codegraphcontext/.env` for `DEFAULT_DATABASE`, Neo4j URI, or Kùzu path. Run `cgc doctor` if connections fail.
3. **Index**: From the repo root, `cgc index .` (or `cgc index --force .` to rebuild). Ensure CLI and MCP use the same config so they see the same graph.
4. **Query**: CLI (`cgc find`, `cgc query`, …) or MCP tools after `cgc mcp setup` / `cgc mcp start` in the client config.
## MCP setup (short)
- Run `cgc mcp setup` and pick the editor, or add a server entry that runs `cgc` with args `mcp` `start` and the same env as the CLI.
- **OpenCode**: Follow the vendor MCP docs for registering a stdio server, then point the command at `cgc` with arguments `mcp`, `start` (same as other editors). Official OpenCode MCP overview: [OpenCode MCP servers](https://opencode.ai/docs/ko/mcp-servers/#_top).
## Agent behavior
- Prefer **indexing the workspace** before deep graph queries if the user has not indexed yet.
… Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.
sections -> When to use this skill → Core workflow → MCP setup (short) → Agent behavior → References in this repo
terms -> Install · uv · Configure · Index · Query · OpenCode · indexing the workspace · fuzzy symbol search
files/cmd -> cgc · codegraphfindcode · analyzecoderelationships · addcodetograph · pip install codegraphcontext · pipx install codegraphcontext · uv tool install codegraphcontext · uvx codegraphcontext …
body sha256 -> fb49767a439a
Decide Fit First
Design Intent
How To Use It
Boundaries And Review