Troubleshooting

hello@ghafoorsblog.com (AG Sayyed) — Mon, 09 Nov 2026 00:00:00 +0000

Troubleshooting

Common Graphify issues and their solutions.

🚨 Quick Diagnosis

 1# 1. Check installation
 2graphify --version
 3
 4# 2. Check graph exists
 5ls -lh graphify-out/graph.json
 6
 7# 3. Check activity signaling
 8cat graphify-out/.graphify-activity.json
 9
10# 4. Test basic query
11mkdir -p graphify-out && touch graphify-out/.graphify-activity
12graphify query "test"

📋 Common Issues

1. `graphify: command not found`

Cause: graphify not in PATH after uv tool install.

Verification

hello@ghafoorsblog.com (AG Sayyed) — Mon, 09 Nov 2026 00:00:00 +0000

Verification

Confirm your Graphify setup is working correctly at every level.

✅ Level 1: Installation

1# Check binary
2graphify --version
3# Output: graphify 0.1.x
4
5# Check model
6ls -lh ~/.cache/graphify/model.gguf
7# Should exist (~1.5-2 GB)

✅ Level 2: Graph Building

 1cd your-project
 2
 3# Signal activity
 4mkdir -p graphify-out && touch graphify-out/.graphify-activity
 5
 6# Build code-only graph
 7graphify . --code-only
 8
 9# Verify graph file
10ls -lh graphify-out/graph.json
11# Should be > 500 KB (3.3 MB in this project)
12
13# Check node/edge counts
14graphify query "project overview" | head -5
15# Should return architectural summary

✅ Level 3: Query Functionality

 1# Signal activity
 2mkdir -p graphify-out && touch graphify-out/.graphify-activity
 3
 4# Test basic query
 5graphify query "project overview"
 6
 7# Test specific component
 8graphify query "how does the dictionary extraction work?"
 9
10# Test path tracing
11graphify path scripts/dictionary/yt-to-content-v2.py tasks/content.yaml
12
13# Test deep-dive
14graphify explain scripts/dictionary/yt-to-content-v2.py

Expected Results

Command	Success Indicator
`graphify query "project overview"`	Returns multi-paragraph architectural summary with file paths
`graphify path A B`	Shows chain of nodes/edges connecting A to B
`graphify explain <file>`	Shows functions, classes, imports, calls in that file

✅ Level 4: Visual Report

1# Generate named communities and HTML report
2graphify cluster-only .
3
4# Check outputs
5ls -lh graphify-out/GRAPH_REPORT.md
6ls -lh graphify-out/graph.html
7
8# Open in browser
9open graphify-out/graph.html

Graph.html Features

Search - Filter nodes by name
Communities - Color-coded groups (e.g., “YouTube Pipeline”, “Dictionary System”)
Node details - Click node to see file, symbols, edges
Zoom/pan - Navigate large graphs

✅ Level 5: Activity Tracking (GraphifyStats)

1# Check activity marker
2cat graphify-out/.graphify-activity.json
3# Should show recent command with timestamp
4
5# Check machine config
6ls -lh ~/.graphify-stats/configured
7# Should exist (created during setup)

VS Code Extension

If using GraphifyStats:

Troubleshooting on Ghafoor's Personal Blog

Troubleshooting

Troubleshooting

🚨 Quick Diagnosis

📋 Common Issues

1. graphify: command not found

Verification

Verification

✅ Level 1: Installation

✅ Level 2: Graph Building

✅ Level 3: Query Functionality

Expected Results

✅ Level 4: Visual Report

Graph.html Features

✅ Level 5: Activity Tracking (GraphifyStats)

VS Code Extension

1. `graphify: command not found`