Codesight CLI는 코드베이스를 스캔하여 AI 코딩 에이전트의 토큰 사용량을 줄입니다.

Codesight의 기능

Codesight는 코드베이스를 스캔하여 AI 어시스턴트를 위한 간결한 컨텍스트 팩을 생성하는 CLI 도구로, .codesight/ 디렉터리에 저장됩니다. 이는 Claude Code와 같은 AI 코딩 에이전트가 각 대화 시작 시 동일한 파일을 반복적으로 탐색하는 것을 방지하며, 이는 일반적으로 실제 작업 시작 전에 25K–60K 토큰을 소비합니다.

작동 방식

리포지토리 루트에서 npx codesight를 실행하세요. 이 도구는 정규식 대신 AST/구조적 파싱을 사용하여 TypeScript(Next.js, Express, Fastify, Hono, Nest, tRPC, React), Python(FastAPI, Django, SQLAlchemy), Go(Gin, Gorm) 스택을 스캔합니다. 여러 파일을 생성합니다:

• CODESIGHT.md – 아키텍처 및 주요 진입점에 대한 1–2k 토큰 개요
• routes.md – 메서드, 경로, 태그가 포함된 모든 API 경로
• schema.md – 주요 필드 및 관계가 포함된 데이터베이스 모델
• components.md – UI 컴포넌트 및 속성
• env.md – 사용 위치 및 누락된 기본값이 포함된 환경 변수
• graph.md – "핫" 파일 및 영향 범위 분석이 포함된 임포트 그래프

영향 범위 분석은 임포트 그래프를 탐색하여 특정 파일에 의존하는 정확한 파일, 경로, 모델을 보여주어 "이것을 변경하면 무엇이 깨질까?"라는 질문에 답하는 데 도움을 줍니다.

통합

CLAUDE.md에 한 줄을 추가하여 Claude가 트리를 탐색하기 전에 .codesight/CODESIGHT.md 및 관련 파일을 읽도록 지시하세요. 이 도구는 MCP 서버 및 Claude Code, Cursor, Codex, Copilot을 위한 사전 구성된 프로필을 제공하므로, 이러한 도구들은 .codesight를 높은 우선순위 컨텍스트로 취급합니다.

벤치마크

실제 프로덕션 코드베이스의 버전 1.3.1 벤치마크:

• SaveMRR(Hono + Drizzle, 4 작업 공간, 92 파일): 5,129 출력 토큰 대 66,040 예상 탐색 토큰(12.9배 감소)
• BuildRadar(raw HTTP + Drizzle, 53 파일): 3,945 출력 토큰 대 46,020 예상 탐색 토큰(11.7배 감소)
• 이들 평균: ≈12.3배 토큰 감소

TypeScript/Next 백엔드에서, 긴 "이해 + 기능 추가 + 변경 사항 검토" 세션에서 Claude가 트리를 탐색하는 대신 Codesight 파일을 읽을 때 40–50K 토큰의 탐색이 회피되었습니다.

기술적 세부사항

런타임 의존성이 없는 단일 npx 바이너리. MIT 라이선스. GitHub에서 https://github.com/Houseofmvps/codesight에서 이용 가능.