Repolode
Houseofmvps

Houseofmvps/codesight

코드베이스를 스캔해 AI 코딩 도우미가 프로젝트를 살피는 데 쓰는 토큰을 줄여 주는 간결한 컨텍스트 파일을 생성하는 CLI입니다.

스타
1,419
포크
127
열린 이슈
2
마지막 커밋
3개월 전

어떤 프로젝트인가요?

codesight는 프로젝트의 라우트, 데이터베이스 모델, UI 컴포넌트, 라이브러리, 환경 변수, import 그래프를 분석한 뒤 결과를 구조화된 마크다운으로 저장하는 CLI 도구입니다. Claude Code, Cursor, GitHub Copilot, Codex 같은 AI 코딩 도우미를 사용하는 개발자는 대화를 시작할 때마다 도우미가 수십 개의 파일을 grep하고 읽게 하는 대신, 이 맵 하나를 불러오면 됩니다.

이 도구는 npx로 실행되며 별도의 설정이나 API 키가 필요하지 않습니다. TypeScript 프로젝트에서는 TypeScript Compiler API를 사용해 코드 구조를 파싱하고, Python, Go, Ruby, Java, Rust, PHP, Swift 등 다른 언어에서는 지원 프레임워크 전반에 정규식 기반 탐지를 적용합니다. 또한 특정 파일을 변경할 때 영향을 받는 파일, 라우트, 모델을 나열하는 blast-radius 명령, 컨텍스트를 주제별 문서로 나누는 선택형 위키 모드, 14개 도구를 제공하는 MCP 서버도 포함합니다.

프로젝트는 런타임 의존성이 전혀 없는 TypeScript로 작성되었으며 Node.js 18 이상을 대상으로 합니다. README에는 여러 오픈소스 및 비공개 프로젝트에서 측정한 토큰 감소 벤치마크가 소개되어 있습니다.

핵심 기능

  • 01라우트, 스키마, 컴포넌트, 환경 변수, 의존성 맵을 마크다운 파일로 생성합니다.
  • 02TypeScript가 설치된 경우 TypeScript Compiler API를 사용해 정밀하게 파싱합니다.
  • 03정규식 탐지를 통해 Python, Go, Ruby, Java, Rust, PHP, Swift, Dart 등 다양한 언어를 지원합니다.
  • 04변경으로 영향을 받는 파일과 라우트를 보여 주는 blast-radius 명령을 제공합니다.
  • 05Claude Code와 Cursor에서 사용할 수 있는 14개 도구를 갖춘 MCP 서버를 제공합니다.
  • 06CLAUDE.md, .cursorrules, codex.md, AGENTS.md 설정 파일을 생성할 수 있습니다.

활용 사례

  • 대규모 모노레포에서 각 세션을 시작할 때 AI 코딩 도우미가 불러오는 컨텍스트를 줄입니다.
  • 수정하기 전에 공유 모듈의 변경으로 영향을 받는 파일, 라우트, 모델을 확인합니다.
  • 코드베이스 전반에서 필수 환경 변수와 기본값이 설정된 환경 변수를 점검합니다.
  • 새 팀원이나 AI 에이전트가 익숙하지 않은 프로젝트의 구조를 빠르게 파악하도록 돕습니다.

토픽

자주 묻는 질문

codesight은(는) 무엇인가요?
코드베이스를 스캔해 AI 코딩 도우미가 프로젝트를 살피는 데 쓰는 토큰을 줄여 주는 간결한 컨텍스트 파일을 생성하는 CLI입니다. codesight는 프로젝트의 라우트, 데이터베이스 모델, UI 컴포넌트, 라이브러리, 환경 변수, import 그래프를 분석한 뒤 결과를 구조화된 마크다운으로 저장하는 CLI 도구입니다. Claude Code, Cursor, GitHub Copilot, Codex 같은 AI 코딩 도우미를 사용하는 개발자는 대화를 시작할 때마다 도우미가 수십 개의 파일을 grep하고 읽게 하는 대신, 이 맵 하나를 불러오면 됩니다.
codesight은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
codesight은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
codesight은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. codesight의 마지막 커밋은 2026년 7월 27일입니다.
codesight은(는) 어디에 사용할 수 있나요?
대규모 모노레포에서 각 세션을 시작할 때 AI 코딩 도우미가 불러오는 컨텍스트를 줄입니다. 수정하기 전에 공유 모듈의 변경으로 영향을 받는 파일, 라우트, 모델을 확인합니다. 코드베이스 전반에서 필수 환경 변수와 기본값이 설정된 환경 변수를 점검합니다. 새 팀원이나 AI 에이전트가 익숙하지 않은 프로젝트의 구조를 빠르게 파악하도록 돕습니다.
codesight은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Houseofmvps/codesight

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

관련 프로젝트