gitnexus cypher

​

Syntax

gitnexus cypher <query>

​

Description

• Custom graph queries beyond what the built-in tools provide
• Advanced analysis requiring multiple hops or complex patterns
• Debugging the knowledge graph schema
• Extracting data for external tools

​

Arguments

​

Options

​

Usage Examples

​

List all functions

gitnexus cypher "MATCH (n:Function) RETURN n.name LIMIT 10"

​

Find all callers of a function

gitnexus cypher "MATCH (caller)-[:CodeRelation {type: 'CALLS'}]->(f:Function {name: 'validateUser'}) RETURN caller.name, caller.filePath"

​

Get class hierarchy

gitnexus cypher "MATCH (c:Class)-[:CodeRelation {type: 'EXTENDS'}]->(parent:Class) RETURN c.name, parent.name"

​

Count nodes by type

gitnexus cypher "MATCH (n) RETURN label(n) AS type, COUNT(*) AS count"

​

Find deeply nested call chains

gitnexus cypher "MATCH path = (a:Function)-[:CodeRelation*4 {type: 'CALLS'}]->(b:Function) RETURN a.name, b.name, length(path)"

​

Specific repository

gitnexus cypher "MATCH (n:Function) RETURN n.name LIMIT 10" --repo backend-api

​

Output Format

{
  "results": [
    {
      "n.name": "validateUser"
    },
    {
      "n.name": "hashPassword"
    },
    {
      "n.name": "generateToken"
    }
  ],
  "rowCount": 3
}

​

Graph Schema

​

Node Types

• File — Source files
• Function — Top-level functions
• Class — Classes
• Interface — Interfaces
• Method — Class methods
• Community — Functional clusters
• Process — Execution flows

​

Relationship Types

• CALLS — Function/method calls another function/method
• IMPORTS — File imports from another file
• EXTENDS — Class extends another class
• IMPLEMENTS — Class implements an interface
• DEFINES — File defines a symbol
• MEMBER_OF — Symbol belongs to a cluster
• STEP_IN_PROCESS — Symbol participates in an execution flow

​

Common Properties

• name — Symbol name
• filePath — Absolute path to file
• line — Line number
• content — Source code (optional)
• uid — Unique identifier

​

Example Queries

​

Find all entry points

gitnexus cypher "MATCH (f:Function) WHERE NOT EXISTS { MATCH (f)<-[:CodeRelation {type: 'CALLS'}]-() } RETURN f.name, f.filePath"

​

Find circular dependencies

gitnexus cypher "MATCH (a:Function)-[:CodeRelation {type: 'CALLS'}]->(b:Function)-[:CodeRelation {type: 'CALLS'}]->(a) RETURN a.name, b.name"

​

Get cluster members

gitnexus cypher "MATCH (s)-[:CodeRelation {type: 'MEMBER_OF'}]->(c:Community {name: 'auth'}) RETURN s.name, label(s)"

​

Find unused functions

gitnexus cypher "MATCH (f:Function) WHERE NOT EXISTS { MATCH (f)<-[:CodeRelation {type: 'CALLS'}]-() } AND NOT EXISTS { MATCH (f)-[:CodeRelation {type: 'STEP_IN_PROCESS'}]->() } RETURN f.name, f.filePath"

​

When to Use

• Built-in tools don’t provide the exact analysis you need
• You want to experiment with custom graph queries
• You’re building external tools that consume GitNexus data
• You need to validate or debug the knowledge graph

• gitnexus query — Search for execution flows
• gitnexus context — Symbol context
• gitnexus impact — Blast radius

​

Cypher Resources

• KuzuDB Cypher Documentation
• Cypher Query Language

​

Multi-Repo Support

gitnexus cypher "MATCH (n:Function) RETURN n.name LIMIT 10" --repo backend-api

​

Output Destination

gitnexus cypher "MATCH (n) RETURN n LIMIT 10" 2> results.json

​

Related Commands

• gitnexus query — Search for execution flows
• gitnexus context — 360-degree symbol view
• gitnexus impact — Blast radius analysis