graphify: 폴더 하나를 에이전트가 묻는 지식 그래프로
한 개발자가 GPTers 저장소 3개, 단어 152만 개를 graphify로 그래프 하나에 접었어요
- 누가
- Safi Shamsi가 Claude Code 스킬로 시작했고, 지금은 Graphify Labs(YC S26)가 Apache-2.0으로 공개해요
- 언제
- 2026년 4월 3일 저장소가 열렸고, 최신 릴리스는 0.9.97(2026년 10월 27일)이에요
- 어디서
- Claude Code, Codex, Cursor, Gemini CLI 등 20여 개 어시스턴트 · macOS, Linux, Windows · 코드는 내 PC에서 분석
이게 불편했어요
큰 저장소에서 에이전트에게 「인증이 DB까지 어떻게 이어져?」라고 물으면, 에이전트는 grep으로 파일을 하나씩 열어 보며 답을 찾아요. 다음 세션에 같은 걸 물으면 또 처음부터 읽고요. 코드 옆에 설계 문서, SQL 스키마, 논문 PDF까지 섞여 있으면 어디서부터 봐야 할지 사람도 감이 안 와요.
그래서 이렇게 풀어요
graphify는 폴더 전체를 한 번 읽어 지식 그래프로 남겨 두고, 그 뒤로는 파일 대신 그래프에 물어보게 해요. 코드는 tree-sitter로 내 PC에서 파싱하니 LLM도 API 키도 쓰지 않고, 연결마다 소스에서 직접 읽은 것(EXTRACTED)인지 추론한 것(INFERRED)인지 꼬리표가 붙어요. 임베딩이나 벡터 DB 없이 진짜 그래프를 따라가기 때문에, 두 개념이 어떤 길로 이어지는지 경로째 보여 줄 수 있어요.

graphify explain "APIRouter"Node: APIRouter Source: routing.py L2210 Community: 2 Degree: 47Connections (47): --> RequestValidationError [uses] [INFERRED] --> .get() [method] [EXTRACTED] <-- __init__.py [imports] [EXTRACTED]graphify path "FastAPI" "ModelField"Shortest path (3 hops): FastAPI --uses--> DefaultPlaceholder <--references-- get_request_handler() --references--> ModelField
이걸로 만든 사람들
GPTers 저장소 3개(파일 1,643개, 단어 약 152만 개)를 graphify로 돌려 노드 4,942개·커뮤니티 166개짜리 그래프를 만들고 과정을 글로 정리했어요.
GPTers 3개 레포 152만 단어를 하루 만에 정리한 이야기
Rootly의 장애·알림·팀 데이터를 graphify 그래프로 바꾸는 임포터(rootly-graphify-importer)를 만들어, 서비스별 장애와 온콜 공백을 graph.html에서 걸러 보게 했어요.
Used Graphify to turn incidents into a queryable knowledge graph
안에서는 이렇게 돌아가요
- 1
나 → /graphify 스킬 (SKILL.md)
graphify install스킬을 ~/.claude/skills/graphify/SKILL.md에 놓고 CLAUDE.md와 PreToolUse 훅에 등록해요graphify/install.py - 2
/graphify 스킬 (SKILL.md) → Claude Code
/graphify .Claude Code가 SKILL.md 순서대로 폴더 파일을 코드·문서·논문·이미지·영상으로 나눠요graphify/detect.py - 3
Claude Code → tree-sitter AST 추출
코드 파일 → 클래스·함수·import·호출코드는 LLM 없이 로컬에서 파싱해 EXTRACTED 연결로 남겨요graphify/extract.py - 4
Claude Code → 의미 추출 서브에이전트
문서·PDF·이미지 묶음Agent 도구로 서브에이전트를 나눠 띄워 노드·엣지 JSON 조각을 받아요. 코드만 있으면 건너뛰어요graphify/skill.md - 5
Claude Code → graphify-out/
병합 → Leiden 커뮤니티 → graph.json두 결과를 합쳐 그래프를 만들고 밀도로 커뮤니티를 나눠 저장해요graphify/cluster.py - 6
graphify-out/ → 나
graph.html · GRAPH_REPORT.md브라우저로 여는 그래프와, 핵심 개념·의외의 연결·추천 질문을 담은 보고서graphify/exporters/html.py - 7
Claude Code → graphify-out/
graphify query / path / explain그다음부터는 원본 파일 대신 graph.json을 읽어 질문에 답해요graphify/cli.py
넣으면 이렇게 나와요
나한테 맞을까요
이럴 때 좋아요
- 처음 맡은 큰 저장소의 구조를 한 장으로 먼저 보고 싶을 때
- 에이전트가 같은 파일을 세션마다 다시 grep하며 읽는 게 답답할 때
- 코드와 설계 문서·SQL 스키마·논문이 한 폴더에 섞여 있는 프로젝트
- 코드를 밖으로 보내면 안 되는 저장소(코드 분석은 로컬에서만 돌아요)
이건 안 돼요
- 문서·PDF·이미지는 어시스턴트 모델이나 설정한 API 키로 읽어서 토큰이 들어요. 코드만 있으면 들지 않아요.
- 노드가 5,000개를 넘으면 graph.html이 커뮤니티 묶음 보기로 바뀌어요(--node-limit로 조정).
- leiden 추가 설치 없이는 Louvain으로 대신 묶여요. 나중에 바꾸면 커뮤니티가 전부 다시 섞여요.
- 늘 켜져 있는 그래프, 여러 저장소 연결, 형식 검증은 유료 Graphify Cloud(14일 무료 체험) 쪽 기능이에요.
발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요