TL;DR

Ix는 로컬에서 코드베이스를 tree-sitter로 파싱해 ArangoDB 기반의 영구 그래프를 생성하는 CLI 도구로, ix map → ix explain/trace/impact 흐름으로 코드·구조·흐름을 쿼리할 수 있습니다. 설치에는 Node.js 22+, Docker, ripgrep 등이 필요하며 설치 스크립트가 대부분 의존성을 자동 설정합니다. README에 따르면 토큰 소비를 30–99.7%까지 줄이고 일일 LLM 사용량을 최소 43% 올린 사례가 있으며, 대규모·낯선 코드베이스 또는 LLM 보조 워크플로에 도입을 권장합니다. 현재 알파 상태이므로 API와 동작 변화 가능성을 감안해야 합니다.

핵심 포인트

• Ix는 명령행 기반 CLI 도구로서 코드베이스를 로컬 그래프로 변환하고 쿼리 가능한 지도 형태로 저장하는 역할을 합니다. 입력으로 로컬 저장소를 받아 tree-sitter로 26개 언어의 심볼·호출·임포트를 파싱하고, 출력으로 ArangoDB에 저장되는 구조화된 그래프를 생성합니다. 이 과정이 로컬에서 지속되므로 LLM이나 개발자가 세션을 넘겨 일관된 시스템 맥락을 참조할 수 있습니다.
• 사용자 워크플로우는 ix map으로 그래프를 생성한 뒤 ix explain/ix trace/ix impact 같은 명령으로 구성 요소의 역할, 흐름, 변경 영향도를 질문하는 형태로 구성됩니다. 내부적으로는 코드 파싱 → 심볼/관계 추출 → 로컬 백엔드(ArangoDB via Docker)에 영구 저장 → CLI/API 쿼리로 결과를 탐색하는 파이프라인이 작동합니다. 이런 구조가 토큰 소모를 줄이고 LLM 응답의 일관성을 높이는 근거가 되며 README에 제시된 수치와 함께 설계 의도를 반영합니다.
• 설치와 실행에는 Node.js 22 이상, Git, ripgrep, Docker 및 Docker Compose 같은 런타임 의존성이 필요합니다. 제공되는 설치 스크립트가 macOS와 Linux에서 누락된 항목을 검사하고 자동으로 세팅하며, Windows 사용자는 Node.js와 Docker Desktop을 사전에 설치해야 합니다. 또한 플랫폼별로 Apple Silicon·Linux·Windows용 사전빌드 바이너리를 제공하고 있으며 Intel Mac은 Homebrew 빌드 경로를 안내합니다.
• 현재 상태는 alpha로서 API와 동작이 급변할 수 있고 문서·행동 양상이 발전 중입니다. 플러그인 에코시스템을 통해 Claude, Codex, OpenClaw, Gemini, OpenCode, Cursor 등 여러 LLM/플랫폼 연동을 지원하므로 특정 LLM 통합을 염두에 둔 환경에서 바로 활용할 수 있습니다. 대규모 코드베이스나 낯선 시스템을 빠르게 파악하거나 LLM 보조 개발 워크플로에 영구적 맥락을 부여하려는 팀에 특히 적합합니다.

벤치마크

이미지 분석