Graphify-Labs/graphify

Graphify

🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇩🇪 Deutsch | 🇫🇷 Français | 🇪🇸 Español | 🇮🇳 हिन्दी | 🇧🇷 Português | 🇷🇺 Русский | 🇸🇦 العربية | 🇮🇷 فارسی | 🇮🇹 Italiano | 🇵🇱 Polski | 🇳🇱 Nederlands | 🇹🇷 Türkçe | 🇺🇦 Українська | 🇻🇳 Tiếng Việt | 🇮🇩 Bahasa Indonesia | 🇸🇪 Svenska | 🇬🇷 Ελληνικά | 🇷🇴 Română | 🇨🇿 Čeština | 🇫🇮 Suomi | 🇩🇰 Dansk | 🇳🇴 Norsk | 🇭🇺 Magyar | 🇹🇭 ภาษาไทย | 🇺🇿 Oʻzbekcha | 🇹🇼 繁體中文 | 🇵🇭 Filipino

AI 코딩 어시스턴트에서 /graphify를 입력하면 전체 프로젝트(코드, 문서, PDF, 이미지, 비디오)를 지식 그래프로 매핑하여 파일을 grep하는 대신 쿼리할 수 있습니다.

Claude Code, Codex, OpenCode, Kilo Code, Cursor, Gemini CLI, GitHub Copilot CLI, VS Code Copilot Chat, Aider, Amp, OpenClaw, Factory Droid, Trae, Hermes, Kimi Code, Kiro, Pi, Devin CLI, Google Antigravity에서 작동합니다.

/graphify.

이것으로 끝입니다. 다음 세 개의 파일이 생성됩니다:

graphify-out/
├── graph.html       모든 브라우저에서 열기 — 노드 클릭, 필터, 검색
├── GRAPH_REPORT.md  하이라이트: 주요 개념, 놀라운 연결, 제안된 질문
└── graph.json       전체 그래프 — 파일을 다시 읽지 않고 언제든지 쿼리 가능

Mermaid 호출 흐름 다이어그램이 포함된 읽기 쉬운 아키텍처 페이지를 보려면 다음을 실행하세요:

graphify export callflow-html

전제 조건

macOS 빠른 설치 (Homebrew):

brew install [email protected] uv

Windows 빠른 설치:

winget install astral-sh.uv

Ubuntu/Debian:

sudo apt install python3.12 python3-pip pipx
# 또는 uv 설치:
curl -LsSf https://astral.sh/uv/install.sh | sh

설치

공식 패키지: PyPI 패키지는 graphifyy(y가 두 개)입니다. PyPI의 다른 graphify* 패키지는 관련이 없습니다. CLI 명령어는 여전히 graphify입니다.

1단계 — 패키지 설치:

# 권장 (격리된 환경; 이후 'graphify'를 찾을 수 없으면 실행: uv tool update-shell):
uv tool install graphifyy

# 대안:
pipx install graphifyy
pip install graphifyy  # PATH 설정이 필요할 수 있음 — 아래 참고 참조

2단계 — AI 어시스턴트에 스킬 등록:

graphify install

끝입니다. AI 어시스턴트를 열고 /graphify.를 입력하세요.

사용자 프로필 대신 현재 저장소에 어시스턴트 스킬을 설치하려면 --project를 추가하세요:

graphify install --project
graphify install --project --platform codex

프로젝트 범위 설치는 현재 디렉터리 아래에 작성됩니다(예: .claude/skills/graphify/SKILL.md 또는 .agents/skills/graphify/SKILL.md와 스킬이 필요 시 로드하는 references/ 사이드카), 그리고 커밋할 수 있는 파일에 대한 git add 힌트를 출력합니다. 프로젝트 범위 설치를 지원하는 플랫폼별 명령어도 동일한 플래그를 허용합니다(예: graphify claude install --project 또는 graphify codex install --project).

PowerShell 참고: /graphify. 대신 graphify.를 사용하세요 — PowerShell에서 슬래시는 경로 구분자입니다.

graphify: command not found? uv tool install / pipx install은 graphify 명령어를 해당 도구 bin 디렉터리(~/.local/bin)에 넣습니다. 설치 직후 셸에서 찾을 수 없는 경우(새로운 macOS + zsh 설정에서 흔함) 해당 디렉터리가 PATH에 없기 때문입니다: uv tool update-shell(또는 pipx ensurepath)을 실행한 후 새 터미널을 여세요. 일반 pip의 경우 Linux에서는 ~/.local/bin을, Mac에서는 ~/Library/Python/3.x/bin을 PATH에 추가하거나 python -m graphify를 실행하세요.

설치 대신 uvx / uv tool run으로 실행? 패키지 이름을 명시하세요(명령어가 아님): uvx --from graphifyy graphify install. 일반 uvx graphify …는 실패합니다(No solution found … no versions of graphify). uv tool run은 첫 번째 단어를 패키지로 읽고, 패키지는 graphifyy이며 graphify 명령어는 그 안에 있기 때문입니다.

가능하면 Mac/Windows에서 pip install을 피하세요. 스킬은 런타임에 graphify-out/.graphify_python에서 Python을 확인합니다. 이 경로가 pip가 패키지를 설치한 환경과 다르면 ModuleNotFoundError: No module named 'graphify'가 발생합니다. uv tool install과 pipx install은 패키지를 자체 환경에 격리하여 이 문제를 완전히 피합니다.

Git 훅과 uv tool / pipx: graphify hook install은 설치 시 현재 인터프리터 경로를 훅 스크립트에 직접 포함시키므로, GUI git 클라이언트 및 CI 실행기에서 ~/.local/bin이 PATH에 없어도 post-commit 훅이 올바르게 실행됩니다. graphify를 재설치하거나 업그레이드하는 경우 graphify hook install을 다시 실행하여 포함된 경로를 새로 고치세요.

플랫폼 선택

Codex 사용자는 병렬 추출을 위해 ~/.codex/config.toml의 [features] 아래에 multi_agent = true도 필요합니다. CodeBuddy는 Claude Code와 동일한 Agent 도구 및 PreToolUse 훅 메커니즘을 사용합니다. Factory Droid는 병렬 하위 에이전트 디스패치에 Task 도구를 사용합니다. OpenClaw와 Aider는 순차 추출을 사용합니다(해당 플랫폼에서는 병렬 에이전트 지원이 아직 초기 단계입니다). Trae는 병렬 하위 에이전트 디스패치에 Agent 도구를 사용하며 PreToolUse 훅을 지원하지 않습니다 — AGENTS.md가 항상 켜져 있는 메커니즘입니다.

--platform agents(별칭 --platform skills)는 일반적인 크로스 프레임워크 Agent-Skills 위치를 대상으로 합니다: 전역 설치는 사양의 사용자 전역 ~/.agents/skills/(npx skills 및 사양을 준수하는 프레임워크에서 읽음), 프로젝트(--project) 설치는 ./.agents/skills/입니다. 기본 graphify install은 설계상 단일 플랫폼(Claude Code)으로 유지됩니다 — .agents/skills를 읽는 모든 프레임워크에서 스킬을 검색 가능하게 하려면 명명된 agents 플랫폼을 사용하세요.

Codex는 /graphify 대신 $graphify를 사용합니다.

선택적 확장 기능

필요한 것만 설치하세요:

CodeBuddy does the same two things as Claude Code: writes a CODEBUDDY.md section telling CodeBuddy to read graphify-out/GRAPH_REPORT.md before answering architecture questions, and installs PreToolUse hooks (.codebuddy/settings.json) that fire before Bash search commands and file reads, nudging toward graphify query instead.

Codex writes to AGENTS.md and also installs a PreToolUse hook in .codex/hooks.json that fires before every Bash tool call — same always-on mechanism as Claude Code.

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).

Kilo Code installs the Graphify skill to ~/.config/kilo/skills/graphify/SKILL.md and a native /graphify command to ~/.config/kilo/command/graphify.md. graphify kilo install also writes AGENTS.md plus a native tool.execute.before plugin (.kilo/plugins/graphify.js + .kilo/kilo.json or .kilo/kilo.jsonc registration) so Kilo gets the same always-on graph reminder behavior through native .kilo config.

Cursor writes .cursor/rules/graphify.mdc with alwaysApply: true — Cursor includes it in every conversation automatically, no hook needed.

What's in the report

• God nodes — the most-connected concepts in your project. Everything flows through these.
• Surprising connections — links between things that live in different files or modules. Ranked by how unexpected they are.
• The "why" — inline comments (# NOTE:, # WHY:, # HACK:), docstrings, and design rationale from docs are extracted as separate nodes linked to the code they explain.
• Suggested questions — 4–5 questions the graph is uniquely positioned to answer.
• Confidence tags — every inferred relationship is marked EXTRACTED, INFERRED, or AMBIGUOUS. You always know what was found vs guessed.

What files it handles