Graphify-Labs/graphify는 프로젝트의 코드, 문서, SQL 스키마, 설정, PDF, 이미지, 영상까지 지식 그래프로 엮는 도구입니다. Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot 등 20개가 넘는 AI 코딩 도구에서 /graphify 스킬로 씁니다. 라이선스는 Apache-2.0이고, 2026년 11월 7일 기준 깃허브 스타가 14만 개입니다.
설치
Python 3.10 이상과 uv(또는 pipx)가 필요합니다.
uv tool install graphifyy # y가 두 개
graphify install # 쓰는 AI 도구를 찾아 스킬을 등록패키지 이름에 주의하세요. PyPI의 공식 패키지는 graphifyy(y 두 개)입니다. README는 graphify로 시작하는 다른 PyPI 패키지들이 공식과 관계없다고 밝힙니다. 이름이 비슷한 패키지를 잘못 깔면 남의 코드를 내 컴퓨터에서 돌리게 됩니다. 명령어 이름은 graphify 그대로입니다.
쓰는 법
AI 도구에서 이렇게 칩니다.
/graphify .결과로 파일 세 개가 생깁니다.
| 파일 | 내용 |
|---|---|
graph.html | 브라우저에서 노드를 누르고, 거르고, 찾는 그래프 |
GRAPH_REPORT.md | 주요 개념, 뜻밖의 연결, 물어볼 만한 질문 |
graph.json | 전체 그래프. 파일을 다시 읽지 않고 언제든 질의 |
그래프가 생기면 파일을 뒤지는 대신 물어봅니다.
graphify explain "APIRouter" # 한 개념과 연결 47개
graphify path "FastAPI" "ModelField" # 두 개념 사이 최단 경로
graphify query "인증은 어디서 처리해?" # 질문에 맞는 부분 그래프어떻게 만드나
- 코드는 tree-sitter로 구문을 분석합니다. 약 40개 언어의 호출, import, 상속을 파일 너머까지 잇고, LLM을 쓰지 않아 코드가 밖으로 나가지 않습니다.
- 문서, PDF, 이미지, 영상은 내 AI 도구의 모델(또는 설정한 백엔드)로 읽습니다.
- 모든 연결에
EXTRACTED(소스에 적힌 것) 또는INFERRED(해석해서 이은 것)가 붙어, 무엇이 확실한지 구분할 수 있습니다. - 임베딩이나 벡터 저장소가 아니라 따라갈 수 있는 실제 그래프입니다.
README에 실린 Graphify Cloud(유료)의 “토큰 80% 절감”은 여러 저장소를 계속 돌리는 클라우드 제품의 설명이고, 무료 CLI의 측정값이 아닙니다.
오늘 할 일
지금 작업 중인 프로젝트에서 /graphify .를 한 번 돌리고 GRAPH_REPORT.md부터 읽어 보세요. 내가 모르던 연결이 한두 개는 나옵니다.
쇼츠로 보기
이 글은 비치콤버스 쇼츠 No.65의 짝 글입니다. 짧은 주소 beachcombers.co.kr/s/65.