16gagent/skills/code-explorer.md

name, description, metadata

name	description	metadata
code-explorer	Search and explore codebases with CodeGraph. Symbol lookup, caller/callee analysis, impact analysis, BFS graph traversal.	openclaw emoji 🔍

Code Explorer — CodeGraph Knowledge Graph

Query codebases through a pre-indexed SQLite knowledge graph with FTS5 full-text search and BFS graph traversal.

When to Use

• "Where is X defined?" → search
• "Who calls X?" → callers
• "What does X call?" → callees
• "What's the impact of changing X?" → impact
• "How does the codebase handle auth?" → search + callers
• Before grep/glob — CodeGraph is faster and more structured

Setup

# Index a codebase (only needed once, or after major changes)
node src/codegraph/index.js index <project_dir>

# Force re-index
node src/codegraph/index.js index . --force

# Check index stats
node src/codegraph/index.js stats

Commands

Search symbols

node src/codegraph/index.js search "function_name"
node src/codegraph/index.js search "auth" --limit 10

Caller/callee analysis

node src/codegraph/index.js callers "login"
node src/codegraph/index.js callees "main"

Impact analysis (BFS traversal)

node src/codegraph/index.js impact "AuthService"

Deep exploration (search + BFS context)

node src/codegraph/index.js explore "how to send HTTP requests"

Languages Supported

JavaScript/TypeScript, Python, Rust, Go, Java, Ruby, Shell, C/C++

Extraction via regex grammars (8 languages, 8+ node types: function/class/method/struct/enum/import/export)

Database

SQLite at .codegraph/codegraph.db with:

• nodes — symbols (name, kind, signature, location)
• edges — relationships (calls, imports, extends, implements)
• files — file metadata with hash-based incremental sync
• nodes_fts — FTS5 full-text search index

Integration Pattern

Query codebase → codegraph search → symbol list → codegraph callers → call graph
                                                              ↓
                                                     codegraph impact → affected files

File Path

• src/codegraph/index.js — main entry (index, search, callers, callees, impact, explore)
• src/codegraph/schema.sql — SQLite schema