Graphify

Tổng quan

Graphify là một skill/CLI cho AI coding assistants, dùng để biến project thành knowledge graph có thể xem, search và query. Thay vì để agent đọc file theo kiểu grep từng mảng rời rạc, Graphify tạo ra graph.html, GRAPH_REPORT.md và graph.json để mô tả các node, quan hệ, khái niệm trung tâm và những kết nối bất ngờ trong codebase.

Điểm hay của Graphify là nó không chỉ xử lý code. README cho biết tool có thể ingest code, Markdown, YAML, SQL, PDF, Office files, ảnh, video/audio và cả URL/YouTube trong một số chế độ. Với code, việc trích xuất chạy local bằng tree-sitter; với tài liệu/media phức tạp, Graphify có thể dùng model API của assistant để rút quan hệ semantic.

Graphify nhắm rất rõ vào workflow agentic coding. Nó hỗ trợ cài vào Claude Code, Codex CLI, OpenCode, Cursor, Gemini CLI, Aider, OpenClaw, Kimi Code và nhiều môi trường khác. Sau khi cài, agent được hướng dẫn đọc GRAPH_REPORT.md trước khi trả lời câu hỏi về repo, giúp giảm tình trạng mò mẫm context hoặc bỏ sót dependency.

Tính năng chính

• Tạo knowledge graph từ codebase và xuất ra HTML viewer, Markdown report và JSON graph
• Phát hiện “god nodes”, surprising connections, design rationale, confidence tags và câu hỏi gợi ý
• Hỗ trợ nhiều nền tảng coding assistant: Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Aider, OpenClaw, Kimi Code
• Xử lý nhiều loại nguồn: code, docs, SQL schema, PDF, Office files, hình ảnh, audio/video và URL
• Có lệnh query/path/explain để hỏi graph trực tiếp từ terminal
• Có MCP server để agent truy cập graph bằng tool-call lặp lại
• Có hook post-commit/post-checkout để tự rebuild graph và merge graph giữa nhiều contributor
• Có chế độ export call-flow HTML, wiki, SVG, GraphML và Neo4j/Cypher

Stack kỹ thuật

Graphify viết bằng Python, yêu cầu Python 3.10+. Package chính thức trên PyPI là graphifyy, còn CLI vẫn là graphify. Phần xử lý code dùng tree-sitter để chạy local; các phần semantic cho docs/PDF/images có thể gọi backend model như Gemini, Kimi, Claude, OpenAI, Ollama hoặc Bedrock tùy cấu hình. Repo dùng license MIT.

Điểm mạnh

• Đánh đúng pain point của AI coding agent: thiếu bản đồ cấu trúc repo trước khi sửa code
• Output vừa thân thiện với người dùng (graph.html, report), vừa hữu ích cho agent (graph.json, MCP server)
• Tích hợp nhiều nền tảng agent nên không bị khóa vào một editor hay một provider
• Có chú ý privacy: code được parse local, không bắt buộc gửi toàn bộ source lên API
• Workflow team khá thực tế: commit graph, rebuild theo hook, merge graph để cả team dùng chung context

Hạn chế

• Với docs, PDF, ảnh hoặc media, Graphify vẫn có thể cần gọi model API bên ngoài; team nhạy cảm dữ liệu phải cấu hình kỹ
• Knowledge graph có thể tạo cảm giác “đầy đủ” hơn thực tế nếu quan hệ inferred/ambiguous không được đọc cẩn thận
• Cần thêm bước vận hành trong repo: install skill, chạy graphify, quyết định commit phần nào của graphify-out/
• Với codebase rất lớn, chi phí thời gian/index và chất lượng clustering cần được kiểm nghiệm riêng
• Tên package PyPI là graphifyy trong khi CLI là graphify, dễ gây nhầm khi cài lần đầu

Phù hợp khi nào

Graphify hợp với developer hoặc team đang dùng AI coding agents trên repo vừa đến lớn, đặc biệt khi agent hay bị lạc context, sửa nhầm dependency hoặc cần hiểu quan hệ giữa app code, schema, docs và infrastructure. Nếu bạn muốn biến repo thành một “bản đồ” mà cả người lẫn agent đều query được, đây là một công cụ rất đáng thử.