marcoaapfortes/Mantic.sh

A structural code search engine for Al agents.

What it solves

Mantic은 AI 에이전트와 개발자를 위해 컨텍스트 검색 오버헤드를 줄이도록 설계된 컨텍스트 인식 코드 검색 엔진입니다. grep이나 ripgrep과 같은 도구에서 흔히 발생하는 "노이즈"가 많은 검색 결과를 속도보다 관련성과 의도를 우선시함으로써 해결하고, AI 에이전트가 가장 적절한 파일만을 받아 토큰 사용량을 줄이고 정확성을 높입니다.

How it works

Mantic은 모든 파일을 무차별적으로 읽는 대신 파일 구조와 메타데이터에서 의도를 추론하는 인프라 레이어를 사용합니다. 프로세스는 다음과 같습니다.

  • Intent Analysis: 쿼리를 UI, 백엔드, 인증 등으로 분류하고 CamelCase 감지와 경로 시퀀스 매칭을 통해 관련 파일을 찾습니다.
  • Structural Scoring: 정확한 파일명 매치, 경로 관련성, 비즈니스 로직 인식(예: .service.ts를 .test.ts보다 우선 순위 부여) 등을 기반으로 파일을 순위 매깁니다.
  • Hybrid Intelligence: 휴리스틱 스코어링과 transformers.js를 이용한 로컬 임베딩 기반 의미 재순위화를 결합해 개념 검색을 수행합니다.
  • Code Intelligence: Tree‑sitter를 활용해 모노레포 전체에서 "정의로 이동" 및 "참조 찾기" 기능을 제공합니다.
  • Learning: 성공적인 검색 패턴을 로컬에 저장해 팀 간 지식을 공유합니다.

Who it’s for

  • AI Agents: 코딩 작업을 위한 고품질, 필터링된 컨텍스트를 제공합니다.
  • Developers: "결제 코드는 어디에 있나요?"와 같은 의도 기반 파일 검색이나 변경의 "폭발 반경"을 분석하고 싶을 때 유용합니다.
  • Teams: 로컬 우선, 프라이버시 보호 검색 도구를 원하고 Git에 커밋할 수 있는 팀에 적합합니다.

Highlights

  • MCP Server Support: Claude Desktop, Cursor, VS Code와 Model Context Protocol을 통해 직접 통합됩니다.
  • Semantic Search: 정확한 키워드 매치 없이도 개념적으로 관련된 코드를 찾는 신경 재순위화를 지원합니다.
  • Zero-Query Mode: 수정된 파일과 관련 종속성을 표시해 컨텍스트를 사전 제공합니다.
  • Local-First: 완전히 로컬에서 실행되며 데이터 외부 전송이 없어 프라이버시와 비용이 제로입니다.
  • Cross-Repo Intelligence: 전체 모노레포에 걸친 "정의로 이동" 및 "참조 찾기"를 제공합니다.