| name | code-graph |
| description | Use when an agent needs lightweight structural navigation of a local codebase: index JS/TS/Python/Bash projects, find symbols, inspect callers/callees, retrieve snippets, and check whether an index is stale. |
code-graph
Build and query an agent-friendly project map for repositories containing JavaScript, TypeScript, Python, or Bash.
Workflow
- Check existing indexes:
omp code-graph projects
- Index the project when missing or stale:
omp code-graph index <repo-path> --project <name>
The indexer skips common dependency/build/local-reference/runtime directories by default, including .git, .next, .claude, .agents, .pi, .memory, .codex, node_modules, dist, build, coverage, vendor, and github. Add project-specific directory names with:
OMP_CODE_GRAPH_EXTRA_SKIP_DIRS=scratch,tmp-worktree omp code-graph index <repo-path> --project <name>
- Use structured commands before broad grep/read:
omp code-graph search "auth" --project <name>
omp code-graph callers "loginUser" --project <name>
omp code-graph callees "handleLogin" --project <name>
omp code-graph snippet "<qualified_name>" --project <name>
- Treat results as navigation hints. Read snippets before making claims about behavior.
Boundaries
- MVP parser: syntax-level extraction, no LSP/type inference.
- CALLS edges are approximate for dynamic dispatch, framework magic, dependency injection, aliases, and same-name functions.
- No vector search, external embedding integration, or code question-answering in this MVP.
CLI
Run omp code-graph --help and individual command --help for current arguments.
