sheetgraph은 Excel 파일과 Google Sheets를 AI 에이전트가 살펴볼 수 있는 요약 보고서와 수식 의존성 그래프로 변환하는 도구다. 제작자에 따르면 원본 셀 값도 함께 저장해 에이전트가 필요할 때 정확한 값을 조회할 수 있으며, 로컬 파일은 기기 밖으로 전송되지 않는다.
도구는 REPORT.md에 시트와 표, 열별 요약, 수식 그룹, 시트 간 데이터 흐름 등을 기록한다. 수식이 직접 입력한 값으로 덮어써진 위치도 표시한다. 제작자가 제시한 예에서는 12만 셀과 수식 3만 2,000개가 있는 송장 원장이 일반 셀 덤프 기준 약 130만 토큰에서 보고서 약 7,000토큰으로 줄었다. 이는 제작자가 든 사례이며, 모든 파일에서 같은 비율로 줄어든다는 뜻은 아니다.
macOS와 Linux에서는 다음 명령으로 설치할 수 있다.
curl -fsSL https://raw.githubusercontent.com/asharma327/sheetgraph/main/install.sh | sh
Windows용 파일은 Releases에서 받을 수 있다. Rust 1.88 이상을 사용하는 경우 cargo install --git https://github.com/asharma327/sheetgraph로 설치할 수도 있다. 기본 추출은 다음과 같이 실행한다.
sheetgraph extract budget.xlsx # writes sheetgraph-out/INDEX.md and sheetgraph-out/budget/
생성된 sheetgraph-out/budget/REPORT.md를 직접 읽거나, 에이전트에 sheetgraph-out/INDEX.md를 제공하면 된다. 도구는 에이전트 스킬도 제공한다. Claude Code에서는 /plugin install sheetgraph --marketplace asharma327/sheetgraph를 사용하고, Codex와 Cursor 등에서는 SKILL.md를 에이전트의 스킬 폴더에 복사하거나 AGENTS.md에 넣도록 안내한다.
Google Sheets를 읽을 때는 인증 정보가 필요하다. --creds, $SHEETGRAPH_TOKEN, $GOOGLE_APPLICATION_CREDENTIALS, gcloud ADC 순서로 인증을 찾으며, 서비스 계정 사용 시 해당 계정 이메일과 시트를 공유해야 한다. 로컬 파일에는 인증이 필요 없다.
현재 버전은 베타인 0.1이며, 보고서 형식과 라이브러리 API가 릴리스 사이에 바뀔 수 있다. 로컬 파일은 최대 1,000만 셀까지 전체를 보관하며, 제작자는 셀 100만 개당 메모리 약 0.2~0.4GB가 든다고 설명한다. 이 한도를 넘는 대형 파일은 큰 시트의 마지막 1,000개 행과 수식을 보존하고 중간 행은 열별 요약으로 대체한다. 이 경우 cells 조회 결과에는 보존된 행만 나타난다. 반면 Google Sheets는 이 셀 예산 없이 전체를 읽으므로, 2,000만 셀에 가까운 시트는 메모리를 수 GB 사용할 수 있다.
그 밖에도 INDIRECT와 OFFSET처럼 참조 대상이 동적인 수식은 그래프 연결이 누락될 수 있다고 안내한다. Google Sheets의 연결된 스크립트·애드온·트리거는 기본 API로 가져오지 못하며, xls·xlsb·ods 파일은 값과 수식, 이름, 병합 영역만 지원한다. 자세한 지원 범위와 제한은 저장소 문서에서 확인할 수 있다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요