SKILL.md
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 # must succeedIf not initialized:
bun add -d @colbymchenry/codegraph
bunx codegraph init -iIndex 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 definitioncallers/callees/impactfor relationship questionsrepomix-context-skillfor full source text of a specific file- Use
rtk-skillfor 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
grepthe whole repo to re-verify Codegraph AST results - Chain
query+ manual file reads whenimpactanswers the question
Staleness
If codegraph status shows pending files after your edits:
bunx codegraph sync