RepoLens: Go로 작성된 인터랙티브 로컬 코드베이스 패커 및 토큰 최적화 도구(TUI/CLI)

RepoLens는 의존성 없는 오픈소스 Go 도구로, 로컬 코드베이스를 LLM 컨텍스트 윈도우에 최적화된 단일 파일로 패킹합니다. Charm의 Bubble Tea를 기반으로 한 Elm 아키텍처 TUI와 여러 스마트 컨텍스트 최적화 메커니즘을 갖추고 있습니다.

주요 기능

• 대화형 파일 탐색기 (TUI): 스페이스바로 파일과 폴더를 재귀적으로 선택합니다. 중첩된 폴더를 시각적으로 펼치거나 접을 수 있습니다.
• 실시간 Tiktoken 카운터: 동적 진행 표시줄이 파일을 선택할 때 실시간으로 컨텍스트 제한 소비량(GPT-4o 인코딩)을 추정합니다.
• 스마트 주석 제거: Go, Python, TypeScript, JavaScript, Shell, HTML, CSS에서 주석과 독스트링을 자동으로 제거하며, 실행 가능한 쉬뱅(#!/bin/bash)은 유지합니다. spf13/cobra 리포지토리 벤치마크: 프롬프트 크기가 621KB에서 518KB로 17.2% 토큰 절감.
• 토큰 기반 파일 분할: 코드베이스가 토큰 임계값(예: --max-tokens 50000)을 초과하면 RepoLens가 출력을 순차적 부분으로 분할하고, 각 부분에 트리 레이아웃 다이어그램을 자동으로 추가합니다.
• 로컬 비밀 스캐너: 잠재적 AWS 키, OpenAI 키, Slack 웹훅, 일반 비밀번호를 플래그합니다. TUI 모드에서는 파일 옆에 노란색 ⚠️ [SECRET!] 경고를 깜빡입니다.
• 강력한 XML 포맷팅: 코드 페이로드를 <![CDATA[ ... ]]> 블록 안에 안전하게 감싸고 중첩된 대괄호를 이스케이프하여 프롬프트 포맷팅 손상을 방지합니다.

빠른 시작

Go로 설치:

go install github.com/catball912/repolens@latest

또는 CLI 모드로 직접 실행:

repolens -n -d . -i "*_test.go,*.log" -o output.md

대상 사용자

로컬 코드베이스를 LLM에 제공(예: 코드 리뷰, 리팩토링, 문서 생성)하면서 파일을 타사 서비스에 업로드하지 않고, 런타임 의존성이 없는 가벼운 컴파일 도구를 원하는 개발자.