Roxabi GitNexus Query
Search the knowledge graph for execution flows and symbols related to a concept. Returns processes (call chains) ranked by relevance.
Entry
/gitnexus-query "authentication flow"
/gitnexus-query "error handling" --limit 10
/gitnexus-query "database connection" --content # include source code
¬query → ask user provide a search term.
Step 0 — Pre-flight
gitnexus status
¬indexed → ask user run /gitnexus-analyze first.
Index stale → warn user, suggest re-indexing.
Step 1 — Run Query
gitnexus query "$QUERY" $FLAGS
| Flag | Effect |
|---|---|
--limit N |
Max processes to return (default: 5) |
--content |
Include full symbol source code |
--context "text" |
Task context for better ranking |
--goal "text" |
What you want to find |
--repo <name> |
Target specific repo if multiple indexed |
Step 2 — Parse JSON Output
{
"processes": [
{
"name": "LoginFlow",
"relevance": 0.95,
"symbols": ["loginHandler", "validateUser", "createSession"]
}
],
"process_symbols": [...],
"definitions": [...]
}
Step 3 — Present Results
Processes (execution flows):
| Process | Relevance | Key Symbols |
|---|---|---|
| LoginFlow | 0.95 | loginHandler, validateUser, createSession |
| TokenRefresh | 0.78 | refreshToken, verifyToken |
Standalone definitions: types/interfaces not in any process.
Step 4 — Follow-up
- Want full symbol context →
/gitnexus-context <symbol> - Want blast radius →
/gitnexus-impact <symbol> - Want full process trace →
gitnexus://repo/{name}/process/{processName}(requires MCP)
$ARGUMENTS