Muvon/octocode

Semantic code searcher and codebase utility

What it solves

AI 어시스턴트는 코드를 평평한 텍스트로 취급하기 때문에 코드베이스 전체 컨텍스트를 이해하는 데 어려움을 겪습니다. 파일 간 관계를 파악하지 못해 의존성 추적, import 탐색, 세션 간 아키텍처 결정 기억 등이 어렵습니다.

How it works

Octocode는 tree‑sitter AST 파싱을 사용해 임의의 텍스트 청크가 아니라 실제 코드 심볼(함수, 클래스 등)을 추출합니다. 그런 다음 프로젝트 전반에 걸친 imports, calls, implements와 같은 관계를 매핑한 GraphRAG 지식 그래프를 구축합니다. 이 구조적 인텔리전스는 Model Context Protocol (MCP) 서버를 통해 노출되어 AI 에이전트가 의미 검색, 코드 시그니처 보기, 의존성 그래프 질의를 수행할 수 있게 합니다.

Who it’s for

Claude Desktop, Cursor, Windsurf 등 MCP 호환 AI 도구를 사용하는 개발자들을 위한 것으로, 로컬 코드베이스에 대한 깊고 구조적인 이해를 AI 어시스턴트에게 제공해 온보딩, 리팩토링, 코드 리뷰를 개선하고자 하는 경우에 적합합니다.

Highlights

  • Structural Intelligence: 표준 RAG를 넘어 코드베이스를 심볼과 관계의 지식 그래프로 인덱싱합니다.
  • Native MCP Integration: 의미 및 구조 검색을 위한 도구를 AI 에이전트에 직접 제공하는 내장 MCP 서버를 제공합니다.
  • Hybrid Search: 의미 유사도와 BM25 전체 텍스트 검색 및 재랭킹을 결합해 검색 정확도를 높입니다.
  • Multi-language Support: tree‑sitter가 지원하는 Rust, Python, TypeScript, Go, C++, Java 등 다양한 언어를 지원합니다.
  • Local-first Privacy: .gitignore를 존중하고 로컬 임베딩 옵션을 제공하는 로컬‑퍼스트 설계입니다.