Repo 토큰: LLM 컨텍스트 윈도우 인식을 위한 GitHub 액션 토큰 개수 배지 추가

Repo Tokens는 코드베이스의 토큰 수를 계산하고 README에 시각적 배지를 추가하여 저장소가 대규모 언어 모델의 컨텍스트 창을 얼마나 차지하는지 나타내는 GitHub Action입니다. 목표는 JavaScript 라이브러리의 번들 크기 배지와 유사하게 토큰 크기를 가시적인 지표로 만들어 AI 코딩 에이전트와 더 호환되는 간결한 코드베이스를 장려하는 것입니다.

작동 방식

이 액션은 토큰화를 위해 tiktoken을 사용합니다. 약 60줄의 인라인 Python 코드를 실행하며 실행 시간은 약 10초 정도 소요됩니다. 복합 액션으로 구현되어 있습니다.

구성 및 출력

컨텍스트 창 크기는 구성 가능하며, 기본값은 200,000 토큰(Claude 모델 크기와 일치)으로 설정됩니다. 배지 색상은 코드베이스가 구성된 컨텍스트 창을 얼마나 채우는지에 따른 비율을 반영합니다:

• 녹색: 30% 미만
• 노란색: 50-70%
• 빨간색: 70% 이상

이 액션은 README 파일을 업데이트하지만 변경 사항을 자동으로 커밋하지 않아 워크플로우가 git 전략을 제어할 수 있도록 합니다.

이러한 유형의 도구는 AI 어시스턴트와 작업하는 개발자에게 유용합니다. 코드베이스를 LLM의 컨텍스트 창 내로 유지하면 에이전트가 코딩 작업 중 프로젝트 구조와 종속성을 완전히 인지할 수 있기 때문입니다.