에이전트가 읽는 bash 출력을 최대 90% 줄이는 고성능 CLI 프록시
웹사이트 • 설치 • 문제 해결 • 아키텍처 • Discord
English • Francais • 中文 • 日本語 • 한국어 • Espanol
--- rtk는 명령 출력이 LLM 컨텍스트에 도달하기 전에 필터링하고 압축합니다. 단일 Rust 바이너리, 의존성 없음, 10ms 미만의 오버헤드. ## RTK가 하는 일 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의 절약이 계산되는 방식](docs/guide/resources/savings-explained.md) ## 설치 ### Homebrew (권장) ```bash brew install rtk ``` ### 빠른 설치 (Linux/macOS) ```bash curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh ``` ### Cargo ```bash cargo install --git https://github.com/rtk-ai/rtk ``` ### 확인 ```bash rtk --version # "rtk 0.27.x" 표시되어야 함 rtk gain # 토큰 절약 통계 표시되어야 함 ``` ## 빠른 시작 ```bash # 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 | 필터 | +-----------------------------------+ +------- (필터링) -----+----------+ ``` 네 가지 전략: 1. **스마트 필터링** - 노이즈 제거 (주석, 공백, 보일러플레이트) 2. **그룹화** - 유사 항목 집계 (디렉토리별 파일, 유형별 에러) 3. **잘라내기** - 관련 컨텍스트 유지, 중복 제거 4. **중복 제거** - 반복 로그 라인을 카운트와 함께 통합 ## 명령어 > 아래 백분율은 RTK의 `바이트 / 4` 추정기로 측정한 **bash 출력 바이트 감소율**입니다. [절약이 계산되는 방식](#절약이-계산되는-방식)을 참조하세요. ### 파일 ```bash rtk ls . # 최적화된 디렉토리 트리 rtk read file.rs # 스마트 파일 읽기 rtk find "*.rs" . # 컴팩트한 검색 결과 rtk grep "pattern" . # 파일별 그룹화 검색 ``` ### Git ```bash rtk git status # 컴팩트 상태 rtk git log -n 10 # 한 줄 커밋 rtk git diff # 압축된 diff rtk git push # -> "ok main" ``` ### 테스트 ```bash rtk jest # Jest 컴팩트 rtk vitest # Vitest 컴팩트 rtk pytest # Python 테스트 (-90%) rtk go test # Go 테스트 (-90%) rtk test