Houseofmvps/codesight

Universal AI context generator. Saves thousands of tokens per conversation in Claude Code, Cursor, Copilot, Codex, and more.

해결하는 문제

AI 어시스턴트는 코드베이스의 구조, 라우트, 스키마를 이해하기 위해 수동으로 탐색하면서 수천 개의 토큰을 낭비하는 경우가 많습니다. codesight는 코드베이스를 압축된 AI 최적화 컨텍스트 맵과 지식 베이스로 사전 컴파일함으로써 이 오버헤드를 줄이고 토큰 사용량을 크게 감소시키며 응답 정확성을 향상시킵니다.

작동 방식

이 도구는 TypeScript 프로젝트에 대해 AST(추상 구문 트리) 정밀도를 사용하고, 다른 지원 언어에 대해서는 검증된 정규식 탐지를 사용합니다. 프로젝트 루트를 스캔하여 라우트, 스키마 모델, UI 컴포넌트 및 의존성 그래프를 식별하며, API 키나 외부 LLM 호출이 필요 없습니다.

컨텍스트는 세 단계로 제공됩니다:

  1. Base Scan: 프로젝트의 컴파일된 맵을 생성(CODESIGHT.md 등).
  2. Wiki Knowledge Base: 지속적이고 타깃이 명확한 마크다운 기사 집합을 생성(auth.md, database.md 등)하여 AI가 전체 맵이 아닌 관련 섹션만 읽을 수 있게 합니다.
  3. Knowledge Mode: ADR, 회의 노트, Obsidian 볼트와 같은 비코드 문서를 KNOWLEDGE.md 프라이머로 매핑합니다.

대상 사용자

Claude Code, Cursor, GitHub Copilot, Windsurf, Cline, Aider 등 AI 코딩 어시스턴트를 사용하면서 토큰 비용을 절감하고 프로젝트 이해를 가속화하고자 하는 개발자를 위한 도구입니다.

주요 특징

  • Zero Dependencies: 설정이나 API 키 없이 npx 한 번 호출로 실행됩니다.
  • 광범위한 언어 지원: TypeScript, JavaScript, Python, Go, Ruby, Elixir, Java, Kotlin, Rust, PHP, Dart, Swift, C#를 지원합니다.
  • 높은 토큰 효율성: 벤치마크 결과, 수동 AI 탐색 대비 최대 91배 토큰 사용량 감소를 보여줍니다.
  • MCP 통합: 14개의 MCP 도구를 포함하여 Claude Code와 같은 어시스턴트가 프로그래밍 방식으로 프로젝트 맵과 위키에 접근할 수 있습니다.
  • Blast Radius 분석: 특정 파일이 변경될 때 영향을 받는 모든 파일, 라우트, 모델을 식별할 수 있습니다.