README_ko.md
rtk는 명령 출력이 LLM 컨텍스트에 도달하기 전에 필터링하고 압축합니다. 단일 Rust 바이너리, 의존성 없음, 10ms 미만의 오버헤드.
RTK는 셸 명령을 가로채 에이전트가 읽기 전에 출력을 압축합니다.
| 작업 | RTK가 출력에 하는 일 |
|---|---|
ls / tree | 항목당 한 줄 대신 파일 개수가 포함된 트리 형식 |
cat / read | 스마트 파일 읽기: 전체 본문 대신 시그니처와 구조 |
grep / rg | 긴 줄을 잘라내고 매치를 파일별로 그룹화 |
git status | 컴팩트한 stat 형식, 상태별 그룹화 |
git diff | 컨텍스트 축소, 헤더 제거 |
git log | 해시, 작성자, 제목만 |
git add/commit/push | 전체 진행 출력 대신 확인 한 줄 |
cargo test / npm test | 실패만 표시, 통과한 테스트는 개수로 축약 |
ruff check | 규칙과 파일별로 그룹화 |
pytest | 실패만 표시, 트레이스백 축약 |
go test | NDJSON 파싱, 실패만 표시 |
docker ps | 핵심 필드만 |
RTK는 에이전트가 읽는 bash 출력을 최대 90% 줄입니다. 이것이 RTK가 측정하는 값이며, 요금이 90% 줄어드는 것과는 다릅니다.
bash 출력은 프롬프트, 시스템 프롬프트, 대화 기록과 함께 입력 토큰을 구성하는 요소 중 하나입니다. 그리고 입력 토큰 역시 출력 토큰까지 포함하는 요금의 일부일 뿐입니다. 감소 효과는 각 단계에서 희석됩니다.
RTK가 보고하는 토큰 수는 바이트 / 4로 추정됩니다. RTK에는 토크나이저가 포함되어 있지 않으므로 비율은 신뢰할 수 있지만 토큰 절대값은 근사치입니다.
전체 설명: RTK의 절약이 계산되는 방식
brew install rtk
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
cargo install --git https://github.com/rtk-ai/rtk
rtk --version # "rtk 0.27.x" 표시되어야 함
rtk gain # 토큰 절약 통계 표시되어야 함
# 1. Claude Code용 hook 설치 (권장)
rtk init --global
# 2. Claude Code 재시작 후 테스트
git status # 자동으로 rtk git status로 재작성
rtk 없이: rtk 사용:
Claude --git status--> shell --> git Claude --git status--> RTK --> git
^ | ^ | |
| ~2,000 tokens (원본) | | ~200 tokens | 필터 |
+-----------------------------------+ +------- (필터링) -----+----------+
네 가지 전략:
아래 백분율은 RTK의
바이트 / 4추정기로 측정한 bash 출력 바이트 감소율입니다. 절약이 계산되는 방식을 참조하세요.
rtk ls . # 최적화된 디렉토리 트리
rtk read file.rs # 스마트 파일 읽기
rtk find "*.rs" . # 컴팩트한 검색 결과
rtk grep "pattern" . # 파일별 그룹화 검색
rtk git status # 컴팩트 상태
rtk git log -n 10 # 한 줄 커밋
rtk git diff # 압축된 diff
rtk git push # -> "ok main"
rtk jest # Jest 컴팩트
rtk vitest # Vitest 컴팩트
rtk pytest # Python 테스트 (-90%)
rtk go test # Go 테스트 (-90%)
rtk test <cmd> # 실패만 표시 (-90%)
rtk lint # ESLint 규칙별 그룹화
rtk tsc # TypeScript 에러 그룹화
rtk cargo build # Cargo 빌드 (-80%)
rtk ruff check # Python 린트 (-80%)
rtk gain # 절약 통계
rtk gain --graph # ASCII 그래프 (30일)
rtk discover # 놓친 절약 기회 발견
기여를 환영합니다! GitHub에서 issue 또는 PR을 생성해 주세요.
Discord 커뮤니티에 참여하세요.
Apache 2.0 라이선스 - 자세한 내용은 LICENSE를 참조하세요.
자세한 내용은 DISCLAIMER.md를 참조하세요.