How do I install the Codegraphcontext skill?

Run npx skillmds@latest add codegraphcontext/codegraphcontext in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Codegraphcontext safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Codegraphcontext?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Codegraphcontext free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Codegraphcontext?

codegraphcontext (@codegraphcontext) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Codegraphcontext by codegraphcontext

Name: Codegraphcontext
Author: codegraphcontext

Codegraphcontext

Use CodeGraphContext (CGC) to index a repo into a graph DB and query it via CLI or MCP. Apply when the user wants semantic/code-graph search, call graphs, indexing, or configuring the codegraphcontext MCP server.

File contents

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 (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 ….
Configure: Optional ~/.codegraphcontext/.env for DEFAULT_DATABASE, Neo4j URI, or Kùzu path. Run cgc doctor if connections fail.
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.
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.

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.path is missing in the DB, that row is skipped for path checks and a warning is logged when repositories are listed; suggest cleaning stale Repository nodes (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

---name: codegraphcontextdescription: Use CodeGraphContext (CGC) to index a repo into a graph DB and query it via CLI or MCP. Apply when the user wants semantic/code-graph search, call graphs, indexing, or configuring the codegraphcontext MCP server.---# 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 workflow1. **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.- 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.path` is missing** in the DB, that row is skipped for path checks and a **warning is logged** when repositories are listed; suggest cleaning stale `Repository` nodes (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`

Frequently asked questions