graphify

Type /graphify in your AI coding assistant and it maps your entire project — code, docs, PDFs, images, videos — into a knowledge graph you can query instead of grepping through files.

Works in Claude Code, Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot CLI, VS Code Copilot Chat, Aider, OpenClaw, Factory Droid, Trae, Hermes, Kimi Code, Kiro, Pi, and Google Antigravity.

/graphify .

That's it. You get three files:

graphify-out/
├── graph.html       open in any browser — click nodes, filter, search
├── GRAPH_REPORT.md  the highlights: key concepts, surprising connections, suggested questions
└── graph.json       the full graph — query it anytime without re-reading your files

For a readable architecture page with Mermaid call-flow diagrams, run:

graphify export callflow-html

Prerequisites

| Requirement | Minimum | Check | Install | |---|---|---|---| | Python | 3.10+ | python --version | python.org | | uv (recommended) | any | uv --version | curl -LsSf https://astral.sh/uv/install.sh \| sh | | pipx (alternative) | any | pipx --version | pip install pipx |

macOS quick install (Homebrew):

brew install python@3.12 uv

Windows quick install:

winget install astral-sh.uv

Ubuntu/Debian:

sudo apt install python3.12 python3-pip pipx
# or install uv:
curl -LsSf https://astral.sh/uv/install.sh | sh

Install

Official package: The PyPI package is graphifyy (double-y). Other graphify* packages on PyPI are not affiliated. The CLI command is still graphify.

Step 1 — install the package:

# Recommended (uv puts graphify on PATH automatically):
uv tool install graphifyy

# Alternatives:
pipx install graphifyy
pip install graphifyy

Step 2 — register the skill with your AI assistant:

graphify install

That's it. Open your AI assistant and type /graphify .

PowerShell note: Use graphify . not /graphify . — the leading slash is a path separator in PowerShell.

graphify: command not found? Use uv tool install graphifyy or pipx install graphifyy — both put the CLI on PATH automatically. With plain pip, add ~/.local/bin (Linux) or ~/Library/Python/3.x/bin (Mac) to your PATH, or run python -m graphify.

Pick your platform

| Platform | Install command | |----------|----------------| | Claude Code (Linux/Mac) | graphify install | | Claude Code (Windows) | graphify install --platform windows | | Codex | graphify install --platform codex | | OpenCode | graphify install --platform opencode | | GitHub Copilot CLI | graphify install --platform copilot | | VS Code Copilot Chat | graphify vscode install | | Aider | graphify install --platform aider | | OpenClaw | graphify install --platform claw | | Factory Droid | graphify install --platform droid | | Trae | graphify install --platform trae | | Trae CN | graphify install --platform trae-cn | | Gemini CLI | graphify install --platform gemini | | Hermes | graphify install --platform hermes | | Kimi Code | graphify install --platform kimi | | Kiro IDE/CLI | graphify kiro install | | Pi coding agent | graphify install --platform pi | | Cursor | graphify cursor install | | Google Antigravity | graphify antigravity install |

Codex users: also add multi_agent = true under [features] in ~/.codex/config.toml. Codex uses $graphify instead of /graphify.

Optional extras

Install only what you need:

| Extra | What it adds | Install | |---|---|---| | pdf | PDF extraction | pip install "graphifyy[pdf]" | | office | .docx and .xlsx support | pip install "graphifyy[office]" | | google | Google Sheets rendering | pip install "graphifyy[google]" | | video | Video/audio transcription (faster-whisper + yt-dlp) | pip install "graphifyy[video]" | | mcp | MCP stdio server | pip install "graphifyy[mcp]" | | neo4j | Neo4j push support | pip install "graphifyy[neo4j]" | | svg | SVG graph export | pip install "graphifyy[svg]" | | leiden | Leiden community detection (Python < 3.13 only) | pip install "graphifyy[leiden]" | | ollama | Ollama local inference | pip install "graphifyy[ollama]" | | openai | OpenAI / OpenAI-compatible APIs | pip install "graphifyy[openai]" | | gemini | Google Gemini API | pip install "graphifyy[gemini]" | | bedrock | AWS Bedrock (uses IAM, no API key) | pip install "graphifyy[bedrock]" | | sql | SQL schema extraction | pip install "graphifyy[sql]" | | all | Everything above | pip install "graphifyy[all]" |

Make your assistant always use the graph

Run this once in your project after building a graph:

| Platform | Command | |----------|---------| | Claude Code | graphify claude install | | Codex | graphify codex install | | OpenCode | graphify opencode install | | GitHub Copilot CLI | graphify copilot install | | VS Code Copilot Chat | graphify vscode install | | Aider | graphify aider install | | OpenClaw | graphify claw install | | Factory Droid | graphify droid install | | Trae | graphify trae install | | Trae CN | graphify trae-cn install | | Cursor | graphify cursor install | | Gemini CLI | graphify gemini install | | Hermes | graphify hermes install | | Kimi Code | graphify install --platform kimi | | Kiro IDE/CLI | graphify kiro install | | Pi coding agent | graphify pi install | | Google Antigravity | graphify antigravity install |

This writes a small config file that tells your assistant to consult the knowledge graph for codebase questions — preferring scoped queries like graphify query "<question>" over reading the full report or grepping raw files. On platforms that support payload-bearing hooks (Claude Code, Gemini CLI), a hook fires automatically before search-style tool calls and nudges your assistant toward the graph path. On the others (Codex, OpenCode, Cursor, etc.), the persistent instruction files (AGENTS.md, .cursor/rules/, etc.) provide the same query-first guidance. GRAPH_REPORT.md is still available for broad architecture review.

To remove graphify from all platforms at once: graphify uninstall (add --purge to also delete graphify-out/). Or use the per-platform command (e.g. graphify claude uninstall).