graphify
무엇인가
graphify는 저장소의 코드·문서·SQL 스키마·설정·PDF를 하나의 질의 가능한 지식 그래프로 바꾸는 CLI다. 코드 검색 계층에 속하며, 파일을 읽어 답을 만드는 대신 그래프를 순회해 답을 찾는 자리를 대체한다. AI 코딩 어시스턴트에 스킬로 등록해 쓴다.
어떻게 동작하나
코드는 tree-sitter AST로 파싱한다. LLM을 쓰지 않고 로컬에서 결정적으로 처리하며 소스가 기계 밖으로 나가지 않는다. 문서·PDF·이미지·영상은 어시스턴트의 모델이나 설정된 API 키로 의미 분석 패스를 수행한다. 결과는 그래프 파일 세 개로 떨어지고, 그중 graph.html은 노드를 개념 단위로, 색을 감지된 커뮤니티 단위로 그려 클릭할 수 있게 한다. 스킬은 실행 시 graphify-out/.graphify_python에서 Python 경로를 해석한다.
무엇과 다른가
벡터 인덱스가 아니다. 임베딩도 벡터 스토어도 만들지 않고, 유사도 검색 대신 실제 그래프를 순회한다. 모든 엣지에는 EXTRACTED(소스에 명시됨) 또는 INFERRED(graphify가 해석으로 연결함) 태그가 붙어, 직접 읽은 관계와 추론한 관계를 구분할 수 있다.
어떻게 쓰나
PyPI 패키지 graphifyy를 uv tool install이나 pipx install로 설치한 뒤 graphify install로 어시스턴트에 스킬을 등록한다. 이후 어시스턴트에서 /graphify . 를 입력하면 프로젝트 매핑이 시작된다. graphify query "질문"은 평문 질문에 범위가 정해진 서브그래프를 돌려주고, graphify path A B는 두 대상 사이의 연결 경로를 추적한다. graphify hook install은 post-commit 훅 스크립트에 현재 인터프리터 경로를 심는다.
전제와 한계
Python 실행 환경이 필요하고, 패키지 이름은 graphifyy지만 명령은 graphify다. uv tool install과 pipx install은 도구 전용 bin 디렉터리에 명령을 넣으므로 PATH에 없으면 uv tool update-shell이나 pipx ensurepath를 실행해야 한다. Mac과 Windows에서는 pip install을 피하는 편이 좋다. 스킬이 graphify-out/.graphify_python에서 Python을 해석하는데 그 경로가 패키지를 설치한 환경과 다르면 ModuleNotFoundError가 난다. --project를 붙이면 사용자 프로필 대신 현재 저장소의 .claude/skills/graphify/SKILL.md 또는 .agents/skills/graphify/SKILL.md에 설치된다. strict 모드는 Claude Code 전용이며 세션의 첫 원본 소스 읽기를 차단하고 그래프로 돌린다.
관련 논문 2
유사 도구
- code-graph-ragTree-sitter로 모노레포를 파싱해 Memgraph 지식 그래프를 만들고, 자연어로 코드를 질의·편집·최적화하는 Python CLI다.
- Graft코드베이스를 링크된 마크다운 노드 그래프로 만들어 저장소에 두고, 코딩 에이전트가 탐색 없이 읽게 하는 TypeScript CLI다.
- Empryo코드베이스를 tree-sitter로 심볼 그래프로 파싱해 두고, 문자열 패치 대신 AST 연산으로 코드를 고치는 데스크톱 AI 코딩 에이전트다.
- graphrag비정형 텍스트에서 LLM으로 개체와 관계를 추출해 지식 그래프 인덱스를 만들고, 그 그래프를 컨텍스트로 질의응답에 쓰는 Python CLI 파이프라인이다.
- Hyper-Extract비정형 텍스트를 LLM으로 구조화해 그래프·하이퍼그래프·시공간 그래프로 추출하는 Python CLI다. 추출·검색·시각화를 한 명령으로 처리한다.
- semantica기업 데이터를 컨텍스트 그래프와 지식 그래프로 적재하고 결정 출처와 추론 경로를 그래프 구조에 남기는 Python 기반 인프라다.