| name | codegraph-skill |
| description | Use when a coding agent needs symbol relationships, callers, callees, or change impact. Guides Codegraph CLI usage (not MCP). |
| version | 1.1.0 |
Codegraph Skill
Codegraph provides a pre-indexed AST code graph for this project.
MindMesh uses CLI only — do not run codegraph install (that configures MCP/agent rules separately).
Prerequisites
bunx codegraph status
If not initialized:
bun add -d @colbymchenry/codegraph
bunx codegraph init -i
Index lives in .codegraph/ (regenerate with bunx codegraph sync after edits).
CLI commands
Always run via bunx codegraph … (or codegraph on PATH):
| Intent | Command |
|---|
| Find symbol by name | bunx codegraph query <name> |
| Who calls X | bunx codegraph callers <symbol> |
| What X calls | bunx codegraph callees <symbol> |
| Change blast radius | bunx codegraph impact <symbol> |
| Tests affected by file changes | bunx codegraph affected <files…> |
| Project file tree | bunx codegraph files |
| Index health | bunx codegraph status |
| Refresh after edits | bunx codegraph sync |
Recommended workflow
- Read
.mind-mesh/agent/context.md (mind-mesh-knowledge-skill)
bunx codegraph query <SymbolName> to locate definition
callers / callees / impact for relationship questions
repomix-context-skill for full source text of a specific file
- Use
rtk-skill for any follow-up shell commands (tests, git)
When to use vs other skills
| Use Codegraph | Use instead |
|---|
| Symbol lookup, call chains | Architecture → context.md |
| Impact before refactor | Business rules → knowledge/ |
| File/symbol graph | Raw source slice → repomix |
| Verbose test/git output | rtk cargo test, rtk git diff |
Do not
- Run
codegraph install (MindMesh manages AGENTS.md)
- Blind
grep the whole repo to re-verify Codegraph AST results
- Chain
query + manual file reads when impact answers the question
Staleness
If codegraph status shows pending files after your edits:
bunx codegraph sync