gitnexus-context

name	gitnexus-context
description	360-degree view of a code symbol — callers, callees, processes it participates in. Triggers: "symbol context" | "show callers" | "gitnexus context" | "who uses this" | "what does X call".

GitNexus Context

Get a 360° view of a single symbol: categorized incoming/outgoing references, process participation, file location.

Entry

/gitnexus-context validateUser
/gitnexus-context AuthService --file src/services/auth.ts
/gitnexus-context getUser --uid "Function:src/db.ts:getUser#0"

¬symbol → ask user provide a symbol name.

Step 0 — Pre-flight

gitnexus status

¬indexed → ask user run /gitnexus-analyze first.

Step 1 — Run Context

gitnexus context "$SYMBOL" $FLAGS

Flag	Effect
--file <path>	Disambiguate common names
--uid <uid>	Direct UID from prior results (zero ambiguity)
--content	Include full symbol source code
--repo <name>	Target specific repo

Step 2 — Parse JSON Output

{
  "symbol": {
    "name": "validateUser",
    "type": "Function",
    "file": "src/auth/validation.ts",
    "line": 42
  },
  "callers": [
    {"name": "loginHandler", "file": "src/auth/login.ts", "line": 15, "confidence": 1.0}
  ],
  "callees": [
    {"name": "checkToken", "file": "src/auth/tokens.ts", "line": 8}
  ],
  "processes": ["LoginFlow", "TokenRefresh"],
  "references": {
    "imports": [...],
    "extends": [...],
    "implements": [...]
  }
}

Step 3 — Present Results

Symbol: validateUser (Function) — src/auth/validation.ts:42

Callers (who calls this):

Symbol	File	Line	Confidence
loginHandler	src/auth/login.ts	15	1.0
apiMiddleware	src/api/middleware.ts	8	1.0

Callees (what this calls):

Symbol	File
checkToken	src/auth/tokens.ts
logAttempt	src/utils/log.ts

Processes (execution flows): LoginFlow, TokenRefresh

Other references: imports, extends, implements, field accesses

Step 4 — Follow-up

• Planning to edit → /gitnexus-impact $SYMBOL
• Want process trace → see process paths above

$ARGUMENTS