Graft 쓸 수 있음 설치형
코딩 에이전트가 매 세션 다시 훑는 코드베이스를 한 번 파싱해 지도로 넘겨주는 CLI+MCP
- 되는 것: 훅 4종·MCP 도구 6개·PageRank 검색이 코드에 실재(2026-09-18 코드 검토)
- 되는 것: 구조 그래프는 API 키 없이 무료 · 23개 언어 파싱 · 정본 저장소 확인(trailhq/Graft)
- 조건: Windows 네이티브는 C++ 툴체인 필요 · Node 22 외 버전은 빌드 실패 보고
- 조건: 벤치마크 재현 불가(하네스 삭제) · 이슈 무응답 57%

무엇인가
레포를 tree-sitter로 파싱해 심볼·호출 그래프와 파일별 마크다운 카드를 만들고, Claude Code 훅으로 매 프롬프트에 관련 파일 지도를 먼저 밀어넣는다. 기본 그래프는 LLM 없이 무료로 만들어지고, 요약이 필요할 때만 내 API 키로 --deep을 돌린다. Cursor·Codex·Gemini 등도 지침 파일로 연결된다.
왜 볼만한가
코딩 에이전트는 작업마다 grep하고 파일 열고 import 따라가며 한 시간 전에 그렸던 그림을 다시 그린다. 그 탐색이 토큰과 시간의 큰 몫이다.
주의할 점
- Windows 네이티브는 C++ 빌드 도구가 있어야 설치된다(문법 파서 하나가 미리 빌드된 파일이 없음, #323). WSL·mac·Linux는 관문 없음. 소스 빌드 시 Node 22 권장
- README의 '최대 4배 절감'은 벤치 스크립트가 레포에서 삭제돼 재현할 수 없다. 자체 표에서도 20~40%대로 읽는 게 안전
- 2026-07 생성 뒤 두 달 반에 태그 10개(v0.7.1→v0.18.0)로 변화가 빠르고, 메인테이너가 9월부터 이슈에 답하지 않는다. 설치 직후 텔레메트리 끄기(graft telemetry disable)