Repolode
ix-infrastructure

ix-infrastructure/Ix

Ix는 저장소를 심볼, 호출, import로 구성된 영구 그래프로 분석해 개발자와 AI 코딩 에이전트가 구조를 조회할 수 있게 합니다.

스타
1,097
포크
82
열린 이슈
25
마지막 커밋
어제

어떤 프로젝트인가요?

Ix는 코드베이스를 심볼, 호출, import, 포함 관계로 이루어진 그래프로 매핑하는 CLI 도구입니다. tree-sitter로 저장소를 파싱하고 결과를 로컬 백엔드에 저장하므로, 매번 검색 결과를 바탕으로 그래프를 다시 만들지 않아도 세션이 바뀐 뒤까지 그래프가 유지됩니다.

CLI에서는 심볼이 무엇인지, 어떤 코드가 해당 심볼을 호출하는지, 무엇에 의존하는지, 변경하면 어떤 부분에 영향이 있는지 등을 질문할 수 있습니다. 출력 형식은 일반 텍스트, JSON, 토큰을 최소화한 LLM 형식 중에서 선택할 수 있습니다. MCP 서버는 Claude Code, Codex, Cursor, VS Code 등 MCP를 지원하는 클라이언트에 동일한 그래프를 제공합니다. `ix view`를 실행하면 Compass라는 시각화 도구가 열립니다.

백엔드는 메모리 레이어를 갖춘 ArangoDB를 사용하는 Docker 이미지로 실행됩니다. 설치 프로그램은 Node.js, ripgrep, Docker가 없는 경우 설치합니다. Apple Silicon macOS, Linux, Windows x86-64용 CLI 패키지가 제공되며, Intel Mac에서는 Homebrew를 통해 소스에서 빌드할 수 있습니다.

핵심 기능

  • 01tree-sitter로 저장소를 파싱해 심볼, 호출, import를 추출합니다.
  • 02코드 그래프를 세션이 바뀐 뒤에도 로컬에 유지합니다.
  • 03특정 심볼에 대해 explain, trace, impact, callers 등의 질의에 답합니다.
  • 04MCP 서버를 제공하며, 여러 AI 클라이언트에 서버를 등록하는 설치 프로그램도 제공합니다.
  • 0527개 프로그래밍 언어와 여러 설정 및 데이터 형식을 지원합니다.

활용 사례

  • 익숙하지 않은 코드베이스의 구조를 빠르게 파악하기.
  • 함수를 수정하기 전에 변경으로 인해 어떤 부분이 깨질 수 있는지 확인하기.
  • 파일 전체를 붙여 넣지 않고 코딩 에이전트에 구조적 맥락 제공하기.
  • 의존하는 코드의 순위를 매겨 핵심 모듈 찾기.

빠른 시작

  1. 1

    README의 공식 설치 스크립트를 실행합니다(macOS/Linux)

  2. 2

    저장소를 매핑합니다

    ix map .
  3. 3

    MCP 서버에 AI 클라이언트를 등록합니다

    ix mcp install

사용 전 알아둘 점

  • 로컬 ArangoDB 백엔드를 사용하려면 Docker와 Docker Compose가 필요합니다.
  • 설치 스크립트는 원격 스크립트를 셸로 파이프하며, Intel Mac에서는 Homebrew로 소스 빌드를 해야 합니다.

토픽

자주 묻는 질문

Ix은(는) 무엇인가요?
Ix는 저장소를 심볼, 호출, import로 구성된 영구 그래프로 분석해 개발자와 AI 코딩 에이전트가 구조를 조회할 수 있게 합니다. Ix는 코드베이스를 심볼, 호출, import, 포함 관계로 이루어진 그래프로 매핑하는 CLI 도구입니다. tree-sitter로 저장소를 파싱하고 결과를 로컬 백엔드에 저장하므로, 매번 검색 결과를 바탕으로 그래프를 다시 만들지 않아도 세션이 바뀐 뒤까지 그래프가 유지됩니다.
Ix은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
Ix은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
Ix은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. Ix의 마지막 커밋은 2026년 10월 21일입니다.
Ix은(는) 어디에 사용할 수 있나요?
익숙하지 않은 코드베이스의 구조를 빠르게 파악하기. 함수를 수정하기 전에 변경으로 인해 어떤 부분이 깨질 수 있는지 확인하기. 파일 전체를 붙여 넣지 않고 코딩 에이전트에 구조적 맥락 제공하기. 의존하는 코드의 순위를 매겨 핵심 모듈 찾기.
Ix는 어떻게 설치하나요?
README의 공식 설치 스크립트를 실행합니다(macOS/Linux) 저장소를 매핑합니다: ix map . MCP 서버에 AI 클라이언트를 등록합니다: ix mcp install
Ix은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ix-infrastructure/Ix

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트