Graphify
코드·문서·이미지를 질의 가능한 지식 그래프로 바꾸는 멀티모달 도구
pip install graphifyy && graphify install코드베이스를 통째로 읽는 대신, tree-sitter로 함수·호출 관계를 추출하고 문서·PDF·이미지까지 묶어 질의 가능한 지식 그래프로 만드는 도구입니다. AI 코딩 도구가 grep과 전체 읽기에 기대지 않고 그래프로 구조를 파악하게 합니다.
판단
이럴 때 씁니다
- 큰 코드베이스의 구조·숨은 의존을 grep·전체읽기 없이 파악하고 싶을 때.
- 코드뿐 아니라 문서·논문·다이어그램까지 한 그래프로 함께 질의하고 싶을 때.
- 같은 질문을 반복하며 토큰을 아끼고 싶을 때. 미리 구운 그래프를 질의합니다.
- 커밋마다 그래프를 자동 갱신해 항상 최신 구조를 유지하고 싶을 때(hook install).
이럴 땐 쓰지 마세요
- 코드를 고치는 작업 자체에는 도움이 적습니다. 그래프는 탐색용이라 수정은 원본 파일을 봐야 합니다.
- 문서·이미지 추출은 Claude API를 쓰므로 완전 오프라인 환경에는 맞지 않습니다.
- 작은 프로젝트라면 그래프를 구워 두는 이득이 크지 않습니다. 규모가 부담이 될 때 값을 합니다.
차별점
- 코드만이 아니라 문서·PDF·이미지(다이어그램·스크린샷)까지 한 그래프에 묶는 멀티모달 추출입니다. 코드는 tree-sitter로, 이미지는 Claude 비전으로 읽습니다.
- /graphify explain·path·query로 god 노드, 두 노드 사이 연결, 개념 설명을 끌어냅니다. 큰 저장소의 숨은 의존을 드러냅니다.
- 같은 질문에 원본 파일을 읽는 것보다 토큰을 71.5배 적게 쓴다는 벤치마크를 내세웁니다(혼합 코퍼스 기준).
- graph.html·graph.json·GRAPH_REPORT.md로 떨어지고, hook install로 커밋마다 자동 재빌드합니다. Obsidian·위키 출력도 지원합니다.
워크플로
- 01pip install graphifyy && graphify install로 설치합니다(이름은 graphifyy).
- 02/graphify .로 프로젝트를 그래프로 빌드합니다.
- 03/graphify explain·path·query로 구조·연결·개념을 질의합니다.
- 04graphify hook install로 커밋마다 자동 재빌드를 걸어 둡니다.
주요 명령
| 명령 | 설명 |
|---|---|
graphify install | Claude Code에 그래프 스킬을 설치합니다 |
/graphify . | 현재 디렉터리를 그래프로 빌드합니다 |
/graphify explain "개념" | 노드 메타데이터와 관계를 설명합니다 |
graphify hook install | 커밋마다 그래프를 자동 재빌드합니다 |
함정
설치 전에 확인하세요
- PyPI 패키지 이름이 graphify가 아니라 graphifyy(y 두 개)입니다. macOS의 externally-managed 환경은 pipx install graphifyy를 권합니다.
- 코드 분석은 로컬 tree-sitter로 돌지만, 문서·이미지 의미 추출은 Claude API를 거칩니다. 완전 오프라인은 아닙니다.
- 그래프는 코드 읽기·탐색용입니다. 수정 작업에는 그래프가 아니라 원본 파일을 봐야 합니다.
직접 써본 메모
큰 저장소를 '읽는' 방식을 바꾸는 도구입니다. 파일을 통째로 떠먹이는 대신 미리 구운 그래프를 질의하니, 같은 질문을 반복할수록 토큰 절감이 체감됩니다. 무엇보다 코드 바깥의 문서·논문·다이어그램까지 한 그래프에 묶는다는 점이, 코드만 보는 다른 그래프 도구와 갈리는 지점입니다.
역할을 분명히 해 두는 게 좋습니다. 한 리뷰는 그래프가 '코드를 읽는 데는 훌륭하지만 고치는 데는 형편없다'고 짚습니다. 수정은 여전히 원본 파일을 봐야 하고, Graphify는 소스 폴더를 대체하는 게 아니라 소스를 '탐색하는 과정'을 대체합니다.
설치에서 한 번 걸리기 쉽습니다. PyPI 이름이 graphify가 아니라 graphifyy(y 두 개)라, 일반 이름으로 깔면 엉뚱한 패키지가 잡힐 수 있습니다. 코드는 로컬에서 처리하지만 문서·이미지 의미 추출은 Claude API를 거치니, 완전 폐쇄망에서는 그 부분이 제약이 됩니다.
비교
같은 코드 인텔리전스라도 Serena가 심볼을 실시간으로 따라간다면, Graphify는 미리 그래프를 구워 두고 질의합니다. code-review-graph가 리뷰의 변경 영향(blast radius)에 초점을 둔다면, Graphify는 코드 바깥의 문서·논문·이미지까지 한 그래프에 묶는 멀티모달이 다릅니다. 단, 그래프는 읽기용이라 코드를 고칠 땐 여전히 원본 파일이 필요합니다.
최근 변경
v0.9.28에서 증분 추출과 교차 파일 엣지, macOS 유니코드 경로, 오래된 그래프 방지, 범위 지정 제거와 Swift 속성 지원이 개선됐다.