CodeGraph + ast-grep

Goal

Use CodeGraph for semantic repository scope and ast-grep for deterministic syntax evidence. Discover installed capabilities, offer relevant stable analysis-tool updates, degrade safely when a tool is missing, and keep every install, update, configuration write, index mutation, and rewrite reviewable.

When to use

• Set up or repair CodeGraph, ast-grep, or their MCP exposure for Codex, Claude Code, Cursor, or another client.
• Explain repository structure, symbols, callers, callees, call paths, routes, imports, or likely impact before editing.
• Find exact syntax shapes, author/test ast-grep rules, or inventory a mechanical migration.
• Reconcile semantic and structural evidence before a refactor or review.
• Check whether selected analysis tools are current and offer an approved update.

When not to use