RTK 완벽 가이드: Rust로 만든 LLM 토큰 압축 도구, 비용 60-90% 절감

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.28.2"가 표시되어야 함
rtk gain        # 토큰 절약 통계가 표시되어야 함

# Claude Code / Copilot (기본값)
rtk init -g

# Gemini CLI
rtk init -g --gemini

# Codex (OpenAI)
rtk init -g --codex

# Cursor
rtk init -g --agent cursor

# Windsurf
rtk init -g --agent windsurf

# Cline / Roo Code
rtk init --agent cline

# Kilo Code
rtk init --agent kilocode

# Google Antigravity
rtk init --agent antigravity

# Claude Code 재시작 후 테스트
git status  # 자동으로 rtk git status로 재작성됨

rtk ls .                        # 지능형 디렉토리 트리 (토큰 -80%)
rtk read file.rs                # 지능형 파일 읽기
rtk read file.rs -l aggressive  # 함수 시그니처만 유지 (함수 본문 제거)
rtk smart file.rs               # 2줄 휴리스틱 코드 요약
rtk find "*.rs" .               # 압축된 find 결과
rtk grep "pattern" .            # 그룹핑된 검색 결과
rtk diff file1 file2            # 압축된 diff (파일이 다르면 exit 1)

rtk git status                  # 컴팩트 상태
rtk git log -n 10               # 한 줄 커밋 기록
rtk git diff                    # 압축된 diff
rtk git add                     # → "ok"
rtk git commit -m "msg"         # → "ok abc1234"
rtk git push                    # → "ok main"
rtk git pull                    # → "ok 3 files +10 -2"

# git push (15줄, ~200 tokens)           # rtk git push (1줄, ~10 tokens)
Enumerating objects: 5, done.             ok main
Counting objects: 100% (5/5), done.
Delta compression using up to 8 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 456 bytes | 456.00 KiB/s, done.
...

rtk pytest                      # Python 테스트 (-90%)
rtk cargo test                  # Rust 테스트 (-90%)
rtk go test                     # Go 테스트 (NDJSON, -90%)
rtk jest                        # Jest 컴팩트 출력
rtk vitest                      # Vitest 컴팩트 출력
rtk playwright test             # E2E 테스트 결과 (실패만)
rtk err <명령어>                  # 임의 명령에서 에러 추출
rtk test <명령어>                  # 범용 테스트 래퍼 — 실패만 (-90%)

rtk tsc                         # TypeScript 에러 파일별 그룹핑
rtk cargo build                 # Cargo 빌드 (-80%)
rtk cargo clippy                # Cargo clippy (-80%)
rtk ruff check                  # Python linting (JSON, -80%)
rtk golangci-lint run           # Go linting (JSON, -85%)
rtk next build                  # Next.js 빌드 압축
rtk prettier --check .          # 포맷이 필요한 파일

rtk docker ps                   # 컴팩트 컨테이너 목록
rtk docker images               # 컴팩트 이미지 목록
rtk docker logs <컨테이너>          # 중복 제거 로그
rtk kubectl pods                # 컴팩트 Pod 목록
rtk kubectl logs <pod>            # 중복 제거 로그

rtk aws sts get-caller-identity # 한 줄 신원 정보
rtk aws ec2 describe-instances  # 컴팩트 인스턴스 목록
rtk aws lambda list-functions   # 이름/런타임/메모리 (키 제거)
rtk aws s3 ls                   # 잘린 목록 + tee로 복구
rtk aws dynamodb scan           # 타입 어노테이션 펼치기

rtk json config.json            # 구조 표시 (값 제거)
rtk deps                        # 의존성 요약
rtk env -f AWS                  # 필터링된 환경변수
rtk log app.log                 # 중복 제거 로그
rtk summary <긴 명령어>             # 휴리스틱 요약

rtk gain                        # 요약 통계
rtk gain --graph                # ASCII 차트 (최근 30일)
rtk gain --history              # 최근 명령 이력
rtk gain --daily                # 일별 상세
rtk gain --all --format json    # JSON 내보내기 (대시보드용)

rtk discover                    # 활용되지 않은 절약 기회 발견
rtk discover --all --since 7    # 모든 프로젝트, 최근 7일

rtk session                     # 최근 세션의 RTK 적용률 표시

-u, --ultra-compact    # ASCII 아이콘 + 인라인 포맷 (추가 토큰 절약)
-v, --verbose          # 상세도 증가 (-v, -vv, -vvv)

# 오늘의 커밋 확인
git log --oneline --since="today"   # rtk가 한 줄 커밋 요약으로 압축

# PR 목록 확인
gh pr list                          # rtk가 컴팩트 PR 테이블로 출력

# 특정 PR 상세 확인
gh pr view 42                       # rtk가 PR 상세 + 상태 체크 출력

# 프로젝트 구조 확인
ls -la                              # rtk 디렉토리 트리 (~150 tokens vs ~800)

# 핵심 파일 확인
read src/main.rs                    # rtk 지능형 읽기 (시그니처 + 핵심 로직 유지)

# 테스트 실행
cargo test                          # rtk 실패 테스트만 (-90%)

# 커밋 & 푸시
git commit -m "feat: add auth"      # rtk → "ok abc1234"
git push                            # rtk → "ok main"

# CI 실행 결과 확인
gh run list                         # rtk 컴팩트 워크플로우 상태

# 실패 원인 파악
docker ps                           # rtk 컴팩트 컨테이너 목록
docker logs my-container            # rtk 중복 제거 로그

# 수정 후 재테스트
rtk test pytest                     # 범용 테스트 래퍼, 실패만 표시

// 의사 코드: RTK의 핵심 처리 흐름
fn process_command(cmd: &str, output: &str) -> String {
    match cmd_type(cmd) {
        CmdType::GitStatus => compact_git_status(output),
        CmdType::TestRunner => failures_only(output),
        CmdType::FileList => group_by_dir(output),
        CmdType::Logs => deduplicate(output),
        CmdType::Build => errors_only(output),
        _ => heuristic_summary(output),
    }
}

brew install rtk      # macOS
rtk init -g           # Claude Code 연동 활성화
# Claude Code 재시작, 토큰 절약 시작