Graphify Knowledge Graph

Graphify builds a local knowledge graph of your entire codebase (code + docs + markdown). Query it with natural language to understand architecture, trace dependencies, and navigate complex projects without reading every file.

Graphify Knowledge Graph

Status: Production Ready ✅
Last Updated: 9 November 2026
Version: 1.0

A local, queryable knowledge graph that indexes your project’s code, documentation, and markdown files. Run architecture queries, trace call chains, and find relationships — all from your terminal.

📚 Quick Navigation

🎯 Get Started

• Project Overview - What Graphify is and how it works
• Getting Started - Installation, setup, and first query

🚀 Main Workflow

• Daily Usage ⭐ START HERE - Common queries for development
• Architecture Questions - Answering “how does X work?”
• Dependency Tracing - Finding what depends on what

📖 How-To Guides

• Code-Only vs Full Graph - When to use each mode
• Adding API Keys - Enable semantic doc extraction
• Rebuilding the Graph - When and how to refresh
• VS Code Integration - GraphifyStats extension

📚 Reference Documentation

• Command Reference - All CLI commands and options
• Node IDs Explained - Understanding node identifiers
• Edge Types - imports_from, calls, contains, etc.
• Troubleshooting - Common issues and fixes

For Different Roles

👨‍💻 Developers

1. Read Getting Started for installation
2. Run your first graphify query "project overview"
3. Use Daily Usage for common patterns
4. Integrate with VS Code via GraphifyStats

🏗️ Architects / Tech Leads

1. Read Project Overview for concepts
2. Use Architecture Questions for system understanding
3. Check Dependency Tracing for impact analysis

🔧 DevOps / Tooling

1. Review Rebuilding for CI/CD integration
2. See Command Reference for automation

Key Features

✅ Local-First - Runs entirely on your machine, no cloud calls for queries
✅ Multi-Language - Python, JavaScript, TypeScript, Go, Rust, and more
✅ Code + Docs - Indexes code (AST) and markdown/docs (semantic with API key)
✅ Natural Language - Query with plain English, not graph syntax
✅ Relationship Mapping - imports, calls, contains, references
✅ Community Detection - Auto-groups related code into named communities
✅ Visual Report - graph.html for browser-based exploration
✅ Zero Runtime Cost - Free after initial model download (~2 GB)

Quick Start

 1# 1. Install (one-time)
 2uv tool install graphifyy && graphify install
 3
 4# 2. Build graph (in your project root)
 5mkdir -p graphify-out && touch graphify-out/.graphify-activity
 6graphify . --code-only        # code only (no API key needed)
 7# OR
 8graphify .                     # full graph (requires LLM API key)
 9
10# 3. Query
11mkdir -p graphify-out && touch graphify-out/.graphify-activity
12graphify query "how does the authentication module work?"
13
14# 4. Explore visually
15open graphify-out/graph.html

Documentation Sections

• 00-overview - System concepts and architecture
• 01-getting-started - Installation and first steps
• 02-workflows - Daily development workflows
• 03-guides - How-to guides and configuration
• 04-reference - Technical reference and troubleshooting

Latest Updates

2026-11-09: Initial documentation created for this project
2026-07-18: Graphify 0.1.0 released

Next Steps

1. New to Graphify? → Getting Started
2. Want to query now? → Daily Usage
3. Need API key setup? → Adding API Keys
4. Troubleshooting? → Reference

In this section

• Graphify Overview
  What Graphify is, how it works, and why use it for codebase understanding.
• Getting Started
  Installation, setup, and first query for Graphify knowledge graph.
  • Setup Guide
    Complete installation and configuration guide for Graphify.
  • First Query
    Run your first Graphify architecture query and understand the output.
  • Verification
    Verify your Graphify installation and graph are working correctly.
• Workflows
  Daily development workflows using Graphify for architecture questions, dependency tracing, and impact analysis.
  • Daily Usage
    Most common Graphify query patterns for daily development work.
  • Architecture Queries
    Advanced architecture questions for system understanding, design reviews, and onboarding.
  • Dependency Tracing
    Trace relationships between components, find call chains, and understand data flow using graphify path.
  • Impact Analysis
    Assess the impact of changes before refactoring — find dependents, trace ripple effects, and plan safe modifications.
• Guides
  How-to guides for Graphify configuration, API keys, rebuilding, and VS Code integration.
  • Code-Only vs Full Graph
    Understand the difference between code-only and full graph modes, and when to use each.
  • Adding API Keys
    Configure LLM API keys for full graph semantic extraction of markdown, docs PDFs, and images.
  • Rebuilding the Graph
    When and how to rebuild the Graphify knowledge graph after code changes branch merges, or configuration updates.
  • VS Code Integration
    Use GraphifyStats VS Code extension for auto-activity signaling, status bar monitoring, and one-click graph exploration.
  • Ignoring Files
    Configure .graphifyignore to exclude files and directories from the knowledge graph.
• Reference
  Technical reference for Graphify commands, node IDs, edge types, and troubleshooting.
  • 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.