npx codeglance 명령어 하나로 코드베이스를 10초 만에 파악할 수 있는 CLI 도구.
개요
Codeglance는 저장소를 열자마자 실행할 수 있는 단일 명령어로 프레임워크, 실행 방법, 시작 지점, 사용 중인 도구를 감지하여 보여준다. 설치나 설정이 필요 없으며, API 키도 요구하지 않는다. 기존 코드 줄 수 계산 도구(tokei, scc)나 소스 코드 덤프 도구(repomix, code2prompt)와 달리, 저장소 오리엔테이션 레이어에 특화되어 다섯 가지 핵심 질문 (이게 무엇인가? 어떻게 실행하는가? 어디서 시작하는가? 어떤 도구를 사용하는가? LLM에 어떻게 전달하는가?) 에 답한다.
동작 방식
Codeglance는 manifest 파일(package.json, go.mod, Cargo.toml, pyproject.toml, CMakeLists.txt)과 디렉터리 구조를 읽어 정보를 추출한다. 소스 코드를 파싱하거나 로직을 이해하지 않으며, 발견된 패턴을 기반으로 휴리스틱하게 분석한다.
—for-ai 모드
codeglance --for-ai 명령어로 300토큰 미만의 구조화된 LLM 컨텍스트 브리프를 생성할 수 있다. 여기에는 스택, 명령어, 주요 파일, 라이브러리, 인프라 정보가 포함된다.
지원 생태계
| 생태계 | Manifest | 감지되는 패키지 예시 |
|---|---|---|
| Node.js | package.json | Next.js, React, Vue, Angular, Express, NestJS, Prisma, tRPC, Vitest, Playwright 등 50+ |
| Python | pyproject.toml, requirements.txt | FastAPI, Django, Flask, SQLAlchemy, Pytorch, LangChain 등 |
| Go | go.mod | Gin, Echo, Fiber, GORM, Cobra, gRPC 등 |
| Rust | Cargo.toml | Axum, Actix-web, Rocket, Tokio, SQLx, Serde 등 |
| C/C++ | CMakeLists.txt | GoogleTest, Catch2, Boost, Qt, OpenCV 등 |
제한 사항
- 휴리스틱 기반으로, manifest 파일이 없는 프로젝트는 분석이 얕다.
- 혼합 생태계 저장소는 첫 번째 감지된 생태계 기준으로 분석된다.
- 라이브러리 저장소(프레임워크 자체)는 자체 프레임워크 이름 대신 의존성을 표시한다.
- Java, Ruby, PHP는 아직 지원되지 않는다 (파일 수는 집계되나 manifest 파싱 안 됨).
- 모노레포는 패키지별 분석 없이 단일 요약을 제공한다.
- 대형 저장소는 25,000개 파일로 제한된다.
- ‘시작할 파일’ 순위는 파일 깊이, 이름 패턴, 크기를 기반으로 한 근사치이다.
사용 사례
- 새 코드베이스 합류: README 읽기, 디렉터리 탐색, package.json 분석에 15분을 소비하지 않고 바로 시작
- 의존성 평가: 라이브러리가 실제로 무엇을 사용하는지 파악
- 오래된 프로젝트 재방문: 몇 달 만에 돌아와서 빠르게 재정립
- AI 도구 사용 전: Claude, Cursor, Copilot에 전체 코드베이스를 덤프하지 않고 컨텍스트 브리프 제공
- 팀 온보딩:
codeglance --markdown > docs/codebase-tour.md로 온보딩 문서 생성
주요 기능
- 프레임워크 감지: 저장소가 어떤 프레임워크를 사용하는지 식별
- 실행/빌드/테스트 명령어: manifest 파일에서 추출한 명령어 제공
- 시작 지점: 주요 파일 목록과 간단한 설명 제공
- 도구 감지: CI/CD, 컨테이너, 린팅 도구 등을 감지
- 언어 통계: 파일 수와 코드 줄 수를 언어별로 제공
- LLM 컨텍스트 브리프: AI 도구에 전달할 수 있는 구조화된 요약
- 제로 설정: 설치나 설정 없이
npx codeglance로 즉시 사용 가능
예시 출력 (charmbracelet/glow)
codeglance glow · Go
charmbracelet/glow
── WHAT IS THIS ──────────────────────────────────────────────────────
CLI tool (Go) using Cobra
── HOW TO RUN IT ─────────────────────────────────────────────────────
go run . run main package
── WHERE TO START ────────────────────────────────────────────────────
main.go main package
── TOOLS DETECTED ────────────────────────────────────────────────────
CI/CD GitHub Actions
── CODEBASE ──────────────────────────────────────────────────────────
Go 25 files 3.6k lines