## Graphify — 그래프 질의보다 흥미로운 커밋 가능한 기억 레이어
**소스:** github.com/safishamsi/graphify (Python · ★ 41.3k · default branch v6, 2026-05-03)
### 한 줄
Graphify는 `/graphify .` 한 번으로 코드·문서·PDF·이미지·영상 폴더를 그래프로 바꾸는 도구지만, 더 중요한 설계는 그 결과를 `graphify-out/`이라는 커밋 가능한 assistant 기억 산출물로 남긴다는 점이다.
### 무엇이 생기나
- `graphify-out/graph.html`: 브라우저에서 노드 클릭·필터·검색이 가능한 시각화.
- `graphify-out/GRAPH_REPORT.md`: god nodes, surprising connections, WHY/HACK 주석, suggested questions가 들어간 사람이 읽는 지도.
- `graphify-out/graph.json`: CLI와 MCP 서버가 다시 질의할 전체 그래프.
### 왜 ‘기억 배포’인가
Graphify는 그래프를 만든 뒤 끝내지 않는다. `graphify claude install`, `graphify codex install`, `graphify hermes install` 같은 명령으로 assistant별 설정을 쓰고, Claude Code·Codex·Gemini CLI처럼 훅을 지원하는 환경에서는 파일 읽기 전에 `GRAPH_REPORT.md`를 먼저 보게 한다. assistant가 원본 파일을 무작정 열기 전에 프로젝트 지도를 먼저 펼치게 만드는 구조다.
### 추출 경계
- 코드: Python, TypeScript, Go, Rust, Java, Kotlin, Swift, SQL 등 25개 언어를 tree-sitter AST로 로컬 처리.
- 문서: `.md`, `.mdx`, `.html`, `.txt`, `.rst`, YAML 계열.
- Office/PDF/Image/Video/YouTube: 옵션 설치와 모델 API 또는 전사 경로를 통해 그래프에 추가.
- 영상·오디오는 faster-whisper 기반 로컬 전사 경로가 있다.
### 리포트가 보여주는 것
`GRAPH_REPORT.md`는 단순 요약보다 디버깅 지도에 가깝다. 가장 연결이 많은 god nodes, 서로 다른 파일·모듈 사이의 surprising connections, 코드 안의 `# NOTE:`, `# WHY:`, `# HACK:` 주석과 docstring의 설계 이유를 뽑아 그래프에 연결한다. 모든 관계에는 `EXTRACTED`, `INFERRED`, `AMBIGUOUS` confidence가 붙어 발견된 사실과 추론된 연결을 분리해 볼 수 있다.
### 직접 질의하는 표면
- `/graphify query "what connects auth to the database?"`
- `/graphify path "UserService" "DatabasePool"`
- `/graphify explain "RateLimiter"`
- `/graphify add <paper-or-youtube-url>`
- `python -m graphify.serve graphify-out/graph.json`으로 MCP stdio 서버 실행
- MCP 도구: `query_graph`, `get_node`, `get_neighbors`, `shortest_path`
### 팀 운용
README는 `graphify-out/`을 git에 커밋하라고 권한다. 한 사람이 `/graphify .`를 실행해 그래프를 만들고 커밋하면, 팀원은 pull 직후 같은 프로젝트 지도를 갖고 assistant를 시작할 수 있다. 대신 `graphify-out/manifest.json`과 `graphify-out/cost.json`은 로컬 전용으로 두라고 한다. mtime 기반 상태와 비용 로그는 저장소에 넣지 않는 편이 안전하기 때문이다.
### 최신 신호
v0.6.8은 `.graphifyignore` negation 패턴, Google Antigravity slash command discovery, Gemini CLI 훅의 Windows CMD/Git Bash 문제, Codex hook-check, thin community 리포트 생략 등을 고쳤다. 이 변경들은 화려한 그래프 UI보다 ‘여러 assistant와 여러 OS에 안정적으로 심기는 기억 레이어’라는 방향을 더 분명히 보여준다.
### 보는 각도
Graphify의 핵심은 “그래프를 만들었다”가 아니다. `graphify-out/`이라는 파일 산출물을 팀 저장소에 남기고, 훅·스킬·MCP로 assistant들이 그 기억을 먼저 읽게 만드는 배포 방식이다.