colbymchenry/codegraph큐레이터 픽

<div align="center">

CodeGraph

🎉 1.0 출시!

이미 설치하셨나요? codegraph upgrade를 실행하여 업데이트하세요.

업데이트 소식은 X에서 @getcodegraph를 팔로우하세요.

Claude Code, Cursor, Codex, OpenCode, Hermes Agent, Gemini, Antigravity, Kiro를 시맨틱 코드 인텔리전스로 강화하세요

정밀한 컨텍스트 · 더 적은 도구 호출 · 더 빠른 답변 · 100% 로컬

문서 및 웹사이트 →

<br>

CodeGraph 플랫폼이 곧 출시됩니다 — 모든 PR에 대해 무엇을 테스트해야 하는지, 무엇이 깨질 수 있는지, 어떤 흐름이 영향을 받는지, 비즈니스 로직이 손상되었는지 정확히 알 수 있습니다.

<a href="https://getcodegraph.com"><img alt="얼리 베타 액세스 대기자 명단" src="https://raw.githubusercontent.com/colbymchenry/codegraph/main/assets/waitlist.svg?v=2" height="52"></a>

_{호스팅 제품의 <b>얼리 베타 액세스</b> 받기 · <a href="https://getcodegraph.com">getcodegraph.com</a>}

</div>

시작하기

1. CLI 설치

Node.js 필요 없음 — 한 줄의 명령어로 OS에 맞는 빌드를 가져옵니다:

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh

# Windows (PowerShell)
irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex

<details> <summary><b>Node가 이미 있나요? npm을 사용하세요 (모든 버전에서 작동)</b></summary>

npm i -g @colbymchenry/codegraph

_{CodeGraph는 자체 런타임을 번들로 제공합니다 — 컴파일할 필요 없고, 네이티브 빌드가 필요 없으며, 모든 곳에서 동일하게 작동합니다. 설치 프로그램은 codegraph를 PATH에 추가하지만 현재 셸을 변경하지는 않습니다 — 다음 단계 전에 새 터미널을 열어 명령어가 제대로 작동하도록 하세요.}

_{언제든지 업그레이드하려면 codegraph upgrade를 실행하세요 — 설치 방법(번들, npm, npx)을 감지하여 그 자리에서 업데이트합니다. --check를 추가하면 업데이트 가능 여부를 확인하고, codegraph upgrade <version>으로 특정 버전을 고정할 수 있습니다.}

</details>

2. 에이전트 연결

새 터미널에서 설치 프로그램을 실행하여 CodeGraph를 사용 중인 에이전트에 연결하세요:

codegraph install

_{Claude Code, Cursor, Codex CLI, opencode, Hermes Agent, Gemini CLI, Antigravity IDE, Kiro를 감지하여 자동으로 구성하고 CodeGraph MCP 서버를 각각에 연결합니다. 이 단계가 CodeGraph를 에이전트에 연결하는 단계입니다; 1단계에서 CLI를 설치하는 것만으로는 자동으로 연결되지 않습니다. 에이전트만 연결할 뿐 어떤 코드도 인덱싱하지 않습니다; 각 프로젝트의 그래프를 구축하는 것은 3단계의 별도 codegraph init입니다. (단축키: npx @colbymchenry/codegraph는 다운로드와 실행을 한 번에 수행합니다.)}

3. 각 프로젝트 초기화

cd your-project
codegraph init

_{codegraph init은 로컬 .codegraph/ 디렉토리를 생성하고 동시에 전체 그래프를 구축합니다 — 하나의 명령어로 완료됩니다.}

<div align="center">

!1CVYnhpys0UHrOuOgpgoyw

</div>

4. 더 이상 동기화할 필요 없음!

자동 동기화는 기본적으로 활성화되어 있습니다. CodeGraph는 프로젝트를 감시하고 파일이 변경될 때마다 그래프를 업데이트합니다 — 에이전트가 코드를 편집하는 동안, 또는 파일을 추가, 수정, 삭제할 때 모두 적용됩니다. 인덱스는 절대 오래되지 않으며, 다시 실행할 필요가 없습니다.

제거

마음이 바뀌셨나요? 한 줄의 명령어로 CodeGraph가 구성된 모든 에이전트에서 제거합니다:

codegraph uninstall

_{설치를 되돌립니다 — CodeGraph의 MCP 서버 구성, 지침, 권한을 각 구성된 에이전트에서 제거합니다. 프로젝트 인덱스(.codegraph/)는 그대로 남아 있습니다. 프로젝트별로 제거하려면 codegraph uninit을 사용하세요. --target을 사용하여 특정 에이전트에서만 제거하거나, --yes를 사용하여 비대화형으로 실행할 수 있습니다.}

왜 CodeGraph인가?

AI 에이전트가 코드를 이해해야 할 때 — 질문에 답하거나 변경을 수행하기 위해 — 느린 방식으로 구조를 발견합니다: grep, glob, Read를 사용하여 파일을 하나씩 읽고, 호출 경로와 의존성을 수동으로 재구축합니다. 이는 실제 작업을 시작하기 전에 많은 도구 호출과 왕복이 발생합니다.

CodeGraph는 에이전트에게 필요한 정확한 코드를 한 번의 호출로 제공합니다. 코드베이스의 모든 심볼, 호출 엣지, 의존성에 대한 사전 구축된 지식 그래프입니다 — 따라서 에이전트는 파일을 크롤링하는 대신 하나의 질문을 하고 관련 소스, 해당 심볼 간의 호출 경로(grep이 따라갈 수 없는 동적 디스패치 홉 포함), 변경의 영향 범위를 돌려받습니다. 파일별 검색이 아닌 정밀한 컨텍스트 — 이는 크고 작은 모든 코드베이스에서 더 적은 도구 호출과 더 빠른 답변을 의미합니다.

<img width="1536" height="1024" alt="토큰 비용 절감 규모" src="https://github.com/user-attachments/assets/eb74a11a-a3ab-4b01-80a6-19f78352ae8e" />

비용에 대한 참고: CodeGraph가 모든 코드베이스에서 제공하는 이점은 정밀도와 속도입니다 — 더 적은 도구 호출, 더 빠른 답변. 토큰 및 달러 비용도 절감하지만, 이러한 절감은 규모에 따라 달라집니다: 적당한 규모의 코드베이스에서는 작고 미미하며, 저장소가 크고 복잡할 때만 실질적입니다 — Google이나 Microsoft의 모노레포 규모에서 팀 전체의 일일 에이전트 사용량이 곱해져 실제 비용 항목이 될 때입니다. 500개 파일 프로젝트에서는 속도를 위해 CodeGraph를 채택하세요. 비용 절감은 코드베이스(및 팀)가 커질 때 나타납니다.

벤치마크 결과

7개의 실제 오픈소스 코드베이스(7개 언어)에서 테스트되었으며, 에이전트(Claude Code, headless)가 하나의 아키텍처 질문에 답변하는 것을 CodeGraph 사용과 미사용으로 비교했습니다. 각 팔의 4회 실행 중앙값입니다. Opus 4.8 (2026-06-02)에서 현재 빌드(주 도구로 codegraphexplore)로 재검증되었습니다._

모든 저장소, 모든 크기에서의 보편적인 이점: 도구 호출 58% 감소 · 22% 더 빠름 · 파일 읽기가 거의 0으로 감소.

신뢰할 수 있는 보편적인 효과는 정밀한 컨텍스트와 속도입니다: CodeGraph는 에이전트의 grep/find/Read 크롤링을 몇 번의 직접 쿼리로 축소합니다 — 수천 줄의 파일에 묻혀 있더라도 요청한 정확한 메서드를 반환 — 따라서 파일 읽기가 거의 0인 상태로 답변하는 반면, CodeGraph가 없는 에이전트는 발견 작업에 예산을 소비합니다. 토큰 및 비용 열도 실제 데이터이지만, 위에서 언급했듯이 규모에 따라 달라집니다: 쿼리당 작고 노이즈가 있으며, 대규모 코드베이스와 높은 볼륨에서만 실제 비용으로 누적됩니다.

_{파일 읽기 = CodeGraph 사용 vs 미사용 시 에이전트가 연 파일의 중앙값 — 정밀한 컨텍스트의 이점을 한 열로 보여줍니다. 토큰 및 비용은 사용/미사용 간의 동일한 차이입니다. 방향성을 가지며(실행마다 변동), 쿼리당 절대값이 작기 때문에 규모가 커져야 비용 항목이 됩니다. codegraph_explore는 또한 중복되는 상호 교환 가능한 구현을 시그니처로 축소하여 응답이 파일 수가 아닌 답변에 맞게 크기가 조정됩니다.}

<details> <summary><strong>저장소별 세부 분석 — 사용 vs 미사용 (4회 중앙값)</strong></summary>

VS Code · ~10k 파일

Excalidraw · ~640 파일

Django · ~3k 파일

Tokio · ~790 파일

OkHttp · ~645 파일

Gin · ~110 파일

Alamofire · ~110 파일

</details>

<details> <summary><strong>전체 벤치마크 세부 정보</strong></summary>

방법론. 각 팔은 claude -p(Claude Opus 4.8)를 headless로 실행하며 --strict-mcp-config를 사용합니다: 사용 = CodeGraph의 MCP 서버 활성화, 미사용 = 빈 MCP 구성. 내장된 Read/Grep/Bash는 둘 다 사용 가능합니다. 저장소당 동일한 질문, 팔당 4회 실행, 중앙값 보고. 비용 = 실행의 totalcostusd; 토큰 = 처리된 총 토큰(입력(캐시 포함) + 출력); 시간 = 실제 경과 시간; 도구 호출 = 모델이 생성한 모든 하위 에이전트 내 호출을 포함한 모든 도구 호출. 저장소는 --depth 1로 클론되고 동일한 CodeGraph 빌드로 인덱싱되었습니다. 2026-06-02에 현재 빌드로 재검증되었습니다. 이 수치는 이전 Opus 4.7 검증보다 낮습니다 — CodeGraph 회귀가 아니라 더 강력한 기본 기준선입니다: Opus 4.8은 대규모 Explore 하위 에이전트 스윕으로 분산하는 대신 메인 스레드에서 효율적으로 grep/읽기를 수행하므로 CodeGraph 미사용 팔이 이전보다 더 가벼워졌습니다. 저장소별 수치는 미사용 팔이 얼마나 많이 탐색하느냐에 따라 실행마다 변동합니다(중앙값 4회로 평활화되지만 꼬리는 남아 있습니다 — 예: Django의 미사용 팔은 한 배치에서 $2.71/14분에 도달했습니다).

질문:

CodeGraph가 이기는 이유: 인덱스를 사용할 수 있으면 에이전트가 직접 답변합니다 — 일반적으로 한 번의 codegraph_explore로 관련 소스를 반환하고, 보통 파일 읽기 없이 중단됩니다. 인덱스가 없으면 에이전트는 올바른 코드를 읽기 전에 발견 작업(find/ls/grep)에 대부분의 예산을 소비합니다. CodeGraph는 직접 쿼리될 때만 도움이 되므로, 지침은 에이전트가 파일 읽기 하위 에이전트에 탐색을 위임하지 않고 직접 답변하도록 유도합니다 — 그렇지 않으면 하위 에이전트가 파일을 읽게 되어 CodeGraph가 오버헤드가 됩니다.

</details>

주요 기능

[...truncated...]