Claude Code, Aider, Gemini CLI와 같은 AI 터미널 에이전트(AI terminal agents)는 개발자 워크플로를 혁신하고 있습니다. 하지만 이러한 에이전트를 통해 셸 명령(shell commands)을 실행하는 것은 컨텍스트 윈도우(context window) 오염의 거대한 원인이 됩니다.

에이전트가 명령(예: npm install --verbose 또는 cargo build)을 실행하면, 출력 스트림에는 수백 줄의 진행 표시줄, 레지스트리 페치(registry fetches), 컴파일 점 표시기(compile dot indicators), 그리고 ANSI 이스케이프 코드(ANSI escape codes)가 LLM으로 흘러 들어갑니다. 당신은 이 노이즈(noise)의 모든 줄에 대해 비용을 지불해야 하며, 이는 컨텍스트 윈도우를 오염시켜 LLM이 집중력을 잃게 만듭니다.

RTK (Rust Token Killer) 소개

RTK는 Rust로 작성된 의존성 없는(zero-dependency) CLI 프록시(proxy)로, AI 에이전트의 도구 라이프사이클(tool lifecycle)에서 Bash 도구 명령을 가로채고, 출력을 압축하여, 깨끗하고 의미론적으로 밀도 높은(semantically dense) 출력을 LLM에 전달합니다.

RTK는 10ms 미만의 오버헤드(overhead)로 도구 호출당 60–90%의 토큰 절감을 달성합니다.

4가지 압축 전략

1. 스마트 필터링 (Smart Filtering): ANSI 터미널 이스케이프 코드, 캐리지 리턴(carriage-return) 애니메이션 오버라이드, 스피너(spinner) 문자 및 빈 줄을 제거합니다.
2. 동적 그룹화 (Dynamic Grouping): 동일한 로그 출력 시퀀스를 하나로 합칩니다 (예: [120 identical lines: "PASS"]).
3. 절단 (Truncation): 처음 몇 줄, 마지막 줄(에러가 나타나는 부분), 그리고 중간 요약을 보존하도록 출력을 지능적으로 제한합니다.
4. 중복 제거 (Deduplication): 반복되는 스택 트레이스(stack trace) 프레임을 통합하여 깨끗한 디버깅 신호를 유지합니다.

전문가 팁 및 주의사항

• Bash Tool Calls Only: 자동 글로벌 훅(rtk init -g)은 셸 명령(shell commands)만 래핑(wrap)합니다. Claude Code의 네이티브 파일 도구(Read, Grep, Edit 등)는 훅을 우회합니다. 출력이 압축되도록 보장하려면 터미널 명령(예: cat 또는 rg)을 사용하세요.
• Crates.io Naming Collision: crates.io의 rtk 크레이트(crate) 이름은 관련 없는 "Rust Type Kit" 라이브러리를 가리킵니다. 토큰 킬러(token killer)를 설치하려면 소스에서 직접 설치하세요:

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

• Fail-Safe Tee Logs: 명령 실행 실패 시, RTK는 상세 내용을 놓치지 않고 디버깅할 수 있도록 전체 로우 로그(raw logs)를 ~/.local/share/rtk/tee/에 기록합니다.

MeshWorld에서 전체 설정 가이드, 벤치마크 및 구성 단계를 확인하세요