Type: Project / Tool Author: mansoor-mamnoon Original Date: 2026-06-03

Summary

codeglance는 npx codeglance 한 줄로 코드베이스의 프레임워크, 실행 방법, 시작 지점, 도구를 감지하는 CLI 도구다. 설치나 설정 없이 즉시 사용 가능하며, 소스 코드 덤프나 라인 카운트 대신 저장소 오리엔테이션을 제공한다. --for-ai 모드로 LLM 컨텍스트 브리프 생성도 가능하다.

주요 인사이트

  • 저장소 오리엔테이션 레이어: 기존 도구(tokei, scc, repomix)와 달리, 코드베이스를 이해하기 위한 핵심 정보(프레임워크, 실행 명령어, 시작 지점)에 집중한다.
  • 제로 설치: npx codeglance 하나로 실행되며, 글로벌 설치도 가능하다.
  • AI 통합: --for-ai 모드로 300토큰 미만의 구조화된 컨텍스트를 LLM에 제공할 수 있어, 전체 코드베이스 덤프보다 효율적이다.
  • 확장성: 각 생태계 감지기는 독립 모듈로, 프레임워크 추가는 약 3줄의 코드 변경으로 가능하다.

세부 사항 / 주요 포인트

  • 지원 생태계: Node.js, Python, Go, Rust, C/C++
  • 지원하지 않는 생태계: Java, Ruby, PHP (파일 수는 집계되나 manifest 파싱 안 됨)
  • 명령어 플래그: --for-ai, --markdown, --json, --output, --no-git
  • 대형 저장소 제한: 25,000개 파일로 제한, 초과 시 안내 메시지 출력
  • 모노레포 지원: 단일 요약 제공, 패키지별 분석 없음
  • 로드맵: v0.2에서 Java/Kotlin, 모노레포 지원, --since diff 모드 계획

관련 위키 페이지