Graft: Claude Code 후크가 grep 토큰을 42% 줄이다

Graft (github.com/NanoNets/Graft)는 Claude Code, Cursor, Codex, Gemini와 같은 코딩 에이전트를 위한 영구 지식 그래프를 구축하는 CLI 도구입니다. 코드베이스 컨텍스트를 미리 계산하여 에이전트가 반복적인 grep-and-open 탐색 루프를 건너뛸 수 있게 합니다.

벤치마크에서 얻은 구체적인 성과

• 토큰 42% 감소 (특히 grep 토큰)
• 도구 호출 46% 감소
• 시간 60% 절약
• SWE-bench Verified에서 정확도 54%에서 66%로 향상

통제된 벤치마크는 동일한 에이전트와 파일 도구로 162회 시도했으며, 컨텍스트만 달랐습니다. SWE-bench 결과는 공식 하네스로 채점되었습니다.

작동 원리

코딩 에이전트는 매 작업마다 저장소를 처음부터 다시 탐색합니다. Graft는 한 번 이해를 구축하고 이를 링크된 마크다운 파일 폴더로 저장소에 기록합니다. 각 시스템, API 또는 개념에 대해 하나의 노드입니다. 이는 실제 설명이며 기호 목록이 아닙니다. 임베딩, 유사성 검색, 데몬이 없습니다.

빠른 시작

npm install -g @nanonets/graft
# CLI 설치, 한 번만
graft init
# 그래프 구축 + Claude Code에 연결

graft init는 연결할 에이전트를 묻고, 코드에서 graft/를 구축하며, 상태 표시줄과 훅을 .claude/에 추가합니다. 그래프는 파일일 뿐입니다. 커밋하면 팀원이 git으로 받을 수 있습니다. graft init --dry-run으로 변경 사항을 미리 볼 수 있습니다.

커밋하는 것은 .claude/ 연결입니다. 각 팀원은 graft build를 실행하여 자신의 그래프를 생성합니다. 그래프는 기본적으로 로컬 캐시로 gitignore됩니다.

추가 기능

• 에이전트 통합을 위한 MCP 서버
• 심층 Claude Code 통합 (상태 표시줄 + 훅)
• 검색 및 방향 파악을 위한 graft grep 및 graft map
• 모노레포 및 멀티 레포 지원
• 그래프 탐색을 위한 graft viz
• Cursor, Codex, Gemini 등과 호환

대상: 대규모 코드베이스에서 AI 코딩 에이전트를 사용하며 이미 탐색한 컨텍스트에 토큰을 지불하는 데 지친 팀.