rtk-ai/rtk

어떤 프로젝트인가요?

핵심 기능

• 01git, grep, ls, 테스트 러너 등 일반적인 셸 명령의 출력을 간결한 형식으로 변환합니다.
• 02런타임 종속성 없이 단일 Rust 바이너리로 제공됩니다.
• 03Claude Code, Cursor, Gemini CLI, Codex, Copilot 등 다양한 에이전트용 훅을 설치합니다.
• 04기록 및 JSON 내보내기를 포함해 rtk gain으로 토큰 절감량을 확인할 수 있습니다.
• 05rtk bypass를 사용하면 추적은 유지하면서 단일 명령의 필터링을 건너뛸 수 있습니다.

활용 사례

• 테스트나 빌드 출력이 많은 대규모 저장소에서 AI 코딩 에이전트를 실행할 때 토큰 비용을 줄입니다.
• 통과한 테스트와 불필요하게 긴 git diff를 요약해 에이전트의 컨텍스트를 핵심 내용에 집중시킵니다.
• rtk discover와 rtk gain으로 어떤 명령에서 필터링 효과를 볼 수 있는지 파악합니다.

빠른 시작

1. 1

   Homebrew로 RTK 설치(macOS / Linux)

   brew install rtk
2. 2

   AI 도구용 hook 설치(기본값은 Claude Code)

   rtk init -g
3. 3

   AI 도구를 다시 시작한 다음 절감 대시보드가 작동하는지 확인

   rtk gain

사용 전 알아둘 점

• !hook은 Bash 도구 호출에서만 실행됩니다. Read, Grep, Glob 같은 내장 도구는 재작성되지 않습니다.
• !토큰 수는 바이트 수 / 4로 추정하므로 실제 수치는 대략적입니다.
• !두 에디션은 같은 이름의 바이너리를 설치하므로 함께 설치할 수 없습니다.
• !RTK 또는 파생물을 제3자에게 상업적으로 제공하려면 별도의 BUSL-1.1 라이선스가 필요합니다.

토픽

자주 묻는 질문

rtk은(는) 무엇인가요?

AI 코딩 에이전트에 전달되기 전 셸 명령 출력을 필터링·압축하는 CLI 프록시 RTK는 AI 코딩 에이전트와 셸 사이에서 동작합니다. 에이전트가 git status, git diff, grep, ls, cargo test, pytest 같은 명령을 실행하면 RTK가 출력을 더 짧은 형식으로 바꿉니다. 테스트 실행 결과는 실패 항목만 표시하고, 검색 결과는 일치 항목을 그룹화하며, 디렉터리 목록은 파일 수로 요약하고, diff는 불필요한 부분을 줄입니다. 일반적인 개발자 명령에서 토큰을 60~90% 줄여 에이전트의 컨텍스트 비용을 낮추는 것이 프로젝트의 목표입니다.

rtk은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

rtk은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

rtk은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. rtk의 마지막 커밋은 2026년 10월 19일입니다.

rtk은(는) 어디에 사용할 수 있나요?

테스트나 빌드 출력이 많은 대규모 저장소에서 AI 코딩 에이전트를 실행할 때 토큰 비용을 줄입니다. 통과한 테스트와 불필요하게 긴 git diff를 요약해 에이전트의 컨텍스트를 핵심 내용에 집중시킵니다. rtk discover와 rtk gain으로 어떤 명령에서 필터링 효과를 볼 수 있는지 파악합니다.

rtk는 어떻게 설치하나요?

Homebrew로 RTK 설치(macOS / Linux): brew install rtk AI 도구용 hook 설치(기본값은 Claude Code): rtk init -g AI 도구를 다시 시작한 다음 절감 대시보드가 작동하는지 확인: rtk gain

rtk은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/rtk-ai/rtk