코드를 작성하기 전에 제안, 명세, 작업에 합의하는 AI 코딩 어시스턴트용 명세 기반 개발 워크플로입니다.
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 통계는 매일 갱신됩니다.
관련 프로젝트
터미널, 데스크톱, 브라우저, 에디터에서 프로젝트를 읽고 파일을 수정하며 명령과 테스트를 실행하는 오픈소스 AI 코딩 에이전트입니다.
코딩 에이전트에 언어 서버나 JetBrains IDE를 통한 IDE 수준의 심볼 검색, 의미 기반 편집 및 리팩터링을 제공하는 MCP 서버입니다.
MCP와 CLI를 통해 AI 코딩 도구에 정확한 리뷰 맥락을 제공하는 로컬 코드 지식 그래프입니다.
터미널에서 코드베이스를 읽고 자연어로 코딩 작업, 코드 설명, Git 워크플로를 처리하는 에이전트형 코딩 도구입니다.
에이전트 플랫폼을 구축하고 API로 제공하며 웹 UI에서 관리하는 Python 프레임워크 및 런타임입니다.