Stay updated — Join the build list for tutorials and AI insights. No spam.

Reference

Technical reference for Graphify commands, node IDs, edge types, and troubleshooting.

Reference

Technical reference for Graphify CLI commands, node identifiers, edge types, and troubleshooting.

📖 Documentation in This Section


🎯 Quick Command Summary

 1# Signal activity (REQUIRED before every command)
 2mkdir -p graphify-out && touch graphify-out/.graphify-activity
 3
 4# Build
 5graphify . [--code-only]           # Initial build
 6graphify update . [--code-only]    # Rebuild
 7
 8# Query
 9graphify query "question"          # Architecture question
10graphify explain <node_id>         # Deep-dive on component
11graphify path <nodeA> <nodeB>      # Trace relationship
12
13# Visualize
14graphify cluster-only .            # Generate GRAPH_REPORT.md + graph.html
15
16# Config
17graphify install                   # Install model + setup
18graphify --version                 # Version info

🔑 Key Concepts

Node ID

Unique identifier for a graph node. Formats:

  • path/to/file.py — File node
  • path/to/file.py:L10 — Symbol at line
  • functionName — Symbol by name
  • ClassName.method — Method

Edge Types

TypeDescription
imports_fromModule imports another
callsFunction calls another
containsFile contains symbol
referencesSymbol references another
readsCode reads file
writesCode writes file

Communities

Auto-detected groups of related nodes (e.g., “YouTube Pipeline”, “Dictionary System”). Named by graphify cluster-only ..


🚨 Common Issues Quick Reference

SymptomFix
command not foundRestart shell; ~/.local/bin in PATH
no LLM API keySet GEMINI_API_KEY or use --code-only
graph.json < 500 bytesRun graphify update . --code-only
no path foundRebuild; nodes not in same graph
stale referencesFull rebuild: graphify . --code-only
permission deniedCheck file permissions; not in .gitignore

Next Steps

In this section

  • Command Reference
    Complete CLI command reference for Graphify.
  • Node IDs Explained
    Understanding Graphify node identifiers — formats, resolution, and usage in queries.
  • Edge Types
    Reference for Graphify edge types — imports_from, calls, contains, references reads, writes.
  • Troubleshooting
    Common Graphify issues and their solutions.
  • Configuration
    Graphify configuration file options and environment variables.