rtk-ai__rtk/README_ko.md

LLM 토큰 소비를 60-90% 줄이는 고성능 CLI 프록시

웹사이트 • 설치 • 문제 해결 • 아키텍처 • Discord

English • Francais • 中文 • 日本語 • 한국어 • Espanol

---

rtk는 명령 출력이 LLM 컨텍스트에 도달하기 전에 필터링하고 압축합니다. 모든 AI 코딩 에이전트와 호환되며, 명령 앞에 rtk를 붙이기만 하면 됩니다. 단일 바이너리, 의존성 없음, 10ms 미만의 오버헤드.

토큰 절약 (30분 코딩 세션)

작업	빈도	표준	rtk	절약
ls / tree	10x	2,000	400	-80%
cat / read	20x	40,000	12,000	-70%
grep / rg	8x	16,000	3,200	-80%
git status	10x	3,000	600	-80%
cargo test / npm test	5x	25,000	2,500	-90%
합계		~118,000	~23,900	-80%

설치

Homebrew (권장)

brew install rtk

빠른 설치 (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh

Cargo

cargo install --git https://github.com/rtk-ai/rtk

확인

rtk --version   # "rtk 0.27.x" 표시되어야 함
rtk gain        # 토큰 절약 통계 표시되어야 함

빠른 시작

모든 에이전트에서 직접 사용:

rtk git status              # 컴팩트 상태
rtk cargo test              # 실패만 표시 (-90%)
rtk grep "pattern" .        # 그룹화된 결과

또는 Claude Code로 자동 재작성:

rtk init --global           # hook 설치
# Claude Code 재시작 — 명령이 자동으로 재작성됩니다
git status                  # → rtk git status (투명)

RTK는 독립 실행형 바이너리입니다. Claude Code hook이 명령을 자동으로 재작성하지만, rtk를 접두사로 붙이면 어떤 에이전트에서도 작동합니다.

작동 원리

  rtk 없이:                                        rtk 사용:

  Agent  --git status-->  shell  -->  git           Agent  --git status-->  RTK  -->  git
    ^                                   |             ^                      |          |
    |        ~2,000 tokens (원본)        |             |   ~200 tokens        | 필터     |
    +-----------------------------------+             +------- (필터링) -----+----------+

네 가지 전략:

1. 스마트 필터링 - 노이즈 제거 (주석, 공백, 보일러플레이트)
2. 그룹화 - 유사 항목 집계 (디렉토리별 파일, 유형별 에러)
3. 잘라내기 - 관련 컨텍스트 유지, 중복 제거
4. 중복 제거 - 반복 로그 라인을 카운트와 함께 통합

명령어

파일

rtk ls .                        # 최적화된 디렉토리 트리
rtk read file.rs                # 스마트 파일 읽기
rtk find "*.rs" .               # 컴팩트한 검색 결과
rtk grep "pattern" .            # 파일별 그룹화 검색

Git

rtk git status                  # 컴팩트 상태
rtk git log -n 10               # 한 줄 커밋
rtk git diff                    # 압축된 diff
rtk git push                    # -> "ok main"

테스트

rtk test cargo test             # 실패만 표시 (-90%)
rtk vitest run                  # Vitest 컴팩트
rtk pytest                      # Python 테스트 (-90%)
rtk go test                     # Go 테스트 (-90%)

빌드 & 린트

rtk lint                        # ESLint 규칙별 그룹화
rtk tsc                         # TypeScript 에러 그룹화
rtk cargo build                 # Cargo 빌드 (-80%)
rtk ruff check                  # Python 린트 (-80%)

분석

rtk gain                        # 절약 통계
rtk gain --graph                # ASCII 그래프 (30일)

Claude Code 전용 (~/.claude/projects/ 세션 파일 읽기):

rtk discover                    # 세션 기록에서 놓친 절약 기회 발견
rtk discover --all --since 7    # 모든 프로젝트, 최근 7일
rtk learn                       # 오류 기록에서 CLI 수정 학습
rtk cc-economics                # Claude Code 세션별 토큰 비용 분석

출시 예정: Aider, Cline, Goose 및 셸 히스토리(모든 에이전트)에서 rtk discover 지원. #273 팔로우.

문서

• TROUBLESHOOTING.md - 일반적인 문제 해결
• INSTALL.md - 상세 설치 가이드
• ARCHITECTURE.md - 기술 아키텍처

기여

기여를 환영합니다! GitHub에서 issue 또는 PR을 생성해 주세요.

Discord 커뮤니티에 참여하세요.

라이선스

MIT 라이선스 - 자세한 내용은 LICENSE를 참조하세요.

면책 조항

자세한 내용은 DISCLAIMER.md를 참조하세요.