Builder Lens는 Claude Code와 Codex의 대화 기록을 자신의 컴퓨터에서 분석해 작업 방식 보고서와 에이전트용 지침 파일을 만드는 오픈소스 도구다. 기록을 업로드하지 않고, 분석에 사용할 모델 호출은 사용자가 이미 쓰는 claude 또는 codex CLI를 거친다.
저장소는 GitHub에서 확인할 수 있다. Python 3.9 이상, macOS 또는 Linux 환경에서 사용할 수 있으며 별도 의존성은 없다. 데모는 실제 기록을 읽지 않고 데이터를 전송하지 않는다.
git clone https://github.com/saranyan/builder-lens.git && cd builder-lens
python3 builder_lens.py --demo # a made-up builder: reads nothing, sends nothing
python3 builder_lens.py # your own projects → out/report.html
기본 설정은 claude CLI의 Haiku를 사용한다. Codex로 분석하려면 --llm codex를 지정하고, 모델 호출 없이 통계만 보려면 --no-llm을 쓴다. 제작자는 두 CLI를 모두 테스트했다고 설명한다.
보고서는 실행·조종·엔지니어링 품질·제품 사고·계획 등 다섯 축의 점수와 의사결정 패턴을 보여준다. 각 주장에는 근거가 되는 측정 사실을 연결하며, 근거를 제시할 수 없는 주장은 제외한다. 성장 영역에는 다음 세션에서 시도할 행동도 제안한다. 다만 ‘추정’으로 표시된 카드에는 아직 가정에 기반한 기준값이 쓰인다. 역추정한 내용과 확신 수준은 REPORT_SPEC.md에 공개돼 있다.
보고서에는 사용자의 세션을 바탕으로 코딩 에이전트에 적용할 지침도 담긴다. --install-skill을 실행하면 Claude Code용 스킬을 설치하고, Codex의 AGENTS.md에 붙여 넣을 파일도 만든다.
python3 builder_lens.py --install-skill # also installs it to ~/.claude/skills/builder-lens-working-style/
도구는 ~/.claude/projects와 ~/.codex/sessions를 읽고, 해당 세션에서 다룬 저장소에서 읽기 전용 git 명령을 실행한다. 모델에 전달하기 전 키·토큰·이메일·전화번호·홈 경로를 가리며, CLI에는 도구를 제공하지 않고 세션도 저장하지 않는다고 저장소는 설명한다. 결과는 ~/.cache/builder-lens에 캐시된다. 약 50개 세션을 처음 분석하는 데 Haiku 기준 약 4분이 걸리며, 이후 실행은 수초가 걸린다.
보고서는 외부 웹 폰트·이미지·스크립트를 불러오지 않는 단일 HTML 파일이며, 열 때 네트워크 요청을 하지 않는다. 자동화된 claude -p, SDK, codex exec, 하위 에이전트 실행은 기본적으로 분석에서 제외되지만 --include-automated로 포함할 수 있다. 저장소는 Y Combinator나 Paxel과 제휴하지 않았다고 밝힌다.
추가 실행 옵션과 시험 명령은 다음과 같다.
python3 builder_lens.py --project my-app # one repo
python3 builder_lens.py --llm codex --workers 6 # Codex, 6 calls at a time
python3 builder_lens.py --model sonnet # a bigger Claude model
python3 builder_lens.py --include-automated # count headless runs too
python3 -m unittest discover -s tests
요금이나 성능을 독립적으로 검증한 자료는 원문에 제시되지 않았다. 라이선스는 MIT다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요