RTK: menos salida de terminal para agentes de código
rtk-ai/rtk · 81.694★ · 5.171 forks
Todo lo que hay que saber sobre rtk-ai/rtk: un proxy de línea de comandos en Rust que filtra la salida de herramientas de desarrollo antes de que llegue al contexto de un modelo de lenguaje.
Qué es RTK
RTK (Rust Token Killer) es un binario de Rust que envuelve comandos de desarrollo y devuelve una versión más compacta de su salida. El objetivo declarado es reducir entre un 60 y un 90 % de los bytes de salida de Bash que ve un agente, no prometer la misma reducción de la factura de un proveedor de modelos.

La distinción es importante: el README explica que la cifra de tokens se estima como bytes / 4, que la salida de Bash es solo una parte de los tokens de entrada y que los tokens de salida también contribuyen al coste. Por tanto, los porcentajes son una medición de compresión de salida, y los totales absolutos son aproximados.
RTK cubre más de cien patrones de comandos: archivos, Git y GitHub CLI, pruebas, analizadores estáticos, gestores de paquetes, AWS, contenedores, Kubernetes, Pulumi y registros. Es una herramienta local: ejecuta el comando subyacente y filtra su resultado; su README declara un binario único, sin dependencias de tiempo de ejecución y menos de 10 ms de sobrecarga.

El origen: un proyecto joven para el coste contextual de los agentes
La API de GitHub fecha la creación del repositorio el 22 de enero de 2026. El README identifica a Patrick Szymkowiak como fundador y a Florian Bruniaux, Adrien Eppling, Nicolas Le Cam y Takayuki Maeda como integrantes principales. La organización rtk-ai describe su propósito como optimizar el trabajo de programación asistido por agentes y enlaza www.rtk-ai.app como sitio del producto.
La tensión que aborda es concreta: los agentes de código ejecutan comandos cuya salida puede ser grande y repetitiva, mientras que los contextos y presupuestos de tokens son finitos. RTK intenta resolverla debajo del agente, con adaptadores o ganchos que reescriben comandos de shell, en vez de pedir al modelo que recuerde llamar manualmente a otro programa.
No se recuperó un anuncio de lanzamiento, una entrada de blog fundacional ni una publicación de X atribuible al equipo con más detalle narrativo. Las publicaciones de Hacker News encontradas acreditan difusión temprana, pero no sustituyen una historia oficial del lanzamiento.
Filosofía y principios
La guía de contribución formula principios operativos que también explican el diseño:
- Corrección antes que ahorro: cuando una persona o el modelo pide salida detallada mediante opciones explícitas, el filtro debe preservar más contenido.
- Transparencia: la salida filtrada debe seguir siendo un subconjunto útil y reconocible de la salida real, sin cabeceras inventadas por RTK.
- No bloquear: si un filtro falla, debe volver a la salida original; los ganchos han de terminar correctamente para que el comando se ejecute sin reescritura.
- Sobrecarga mínima: la documentación pide menos de 10 ms de arranque, sin llamadas de red ni lecturas de disco en la ruta crítica.
- Extensibilidad: los filtros sencillos pueden declararse en TOML; los que requieren análisis estructurado o estado se implementan en Rust.

Cómo funciona
Al usar rtk git status, rtk pytest o rtk docker logs, RTK ejecuta la herramienta correspondiente y aplica una estrategia dependiente del comando: elimina ruido, agrupa elementos similares, recorta redundancias o deduplica líneas repetidas. Por ejemplo, compacta git status, conserva fallos y reduce pruebas aprobadas a un contador, o agrupa diagnósticos de ruff por regla y archivo.

La integración automática instala un gancho que transforma una llamada de Bash como git status en rtk git status antes de ejecutarla. En herramientas sin ese tipo de gancho se usan sus mecanismos documentados: instrucciones en AGENTS.md para Codex, reglas de proyecto para Windsurf, Cline/Roo Code, Kilo Code, Antigravity y Kimi, o extensiones y complementos para OpenCode, OpenClaw, Pi y Hermes.
El límite práctico es igual de relevante: los ganchos de Claude Code solo interceptan llamadas de Bash. Sus herramientas internas Read, Grep y Glob no se reescriben; para esos casos el README recomienda usar comandos de shell o invocar rtk read, rtk grep o rtk find de forma explícita.
Estado oficial y semioficial
No se recuperó evidencia de que RTK haya sido aceptado en un mercado oficial de Anthropic, OpenAI, Cursor u otro proveedor, ni de un aval formal de estos. Su estado es semioficial en el sentido técnico, no institucional: el propio repositorio mantiene adaptadores para quince entornos, incluidos Claude Code, Copilot, Gemini CLI, Codex, Cursor, OpenCode, OpenClaw, Pi, Hermes y Factory Droid. Cada integración utiliza la interfaz de ganchos, reglas o complementos que el entorno ofrece.

La documentación no afirma que esos proveedores certifiquen RTK, sus resultados ni su seguridad. La adopción visible —74.931 estrellas en GitHub al medirlo— puede indicar interés, pero no constituye una designación de estándar.
El ecosistema
Repositorios de rtk-ai
La consulta de repositorios públicos de la organización recuperó los siguientes proyectos relacionados por pertenecer a la misma organización; no todos son dependencias de RTK:
rtk-ai/vox(155 estrellas): kit de herramientas para reconocimiento y síntesis de voz de baja latencia.rtk-ai/icm(516 estrellas): memoria persistente para agentes, binario sin dependencias y nativo para MCP.rtk-ai/grit(109 estrellas): propuesta de control de versiones para agentes y trabajo paralelo sobre el mismo código.rtk-ai/homebrew-tap(19 estrellas): repositorio de fórmulas Homebrew parartkyvox.rtk-ai/rtk-ldp(9 estrellas): página de aterrizaje de RTK.rtk-ai/rtk-pro-releases(0 estrellas): publicaciones y documentación de RTK Pro.
Bifurcaciones, extensiones y traducciones
La API de bifurcaciones no mostró una traducción comunitaria con identidad propia entre las veinte más destacadas. Sí encontró thehoff/contextcrawler (4 estrellas), una bifurcación cuya descripción declara integrar capacidades procedentes de RTK y ContextZip con mejoras de seguridad. También aparecen dioptx/rtk-plus (6 estrellas) y algolia/rtk (6), pero sus descripciones son las del proyecto ascendente; por eso deben tratarse como bifurcaciones y no como puertos verificados.
El proyecto sí mantiene internacionalización oficial en el repositorio: README_es.md, README_fr.md, README_zh.md, README_ja.md, README_ko.md y README_pt.md, además del README principal. Esto demuestra soporte documental multilingüe, no la existencia de proyectos separados.
Números del repositorio
Medición: 6 de agosto de 2026, API pública de GitHub.
| Métrica | Valor |
|---|---|
| Estrellas | 74.931 |
| Bifurcaciones | 4.716 |
| Suscriptores reales | 192 |
| Commits | 1.451 |
| Incidencias abiertas según la API | 1.887 |
| Lenguaje principal | Rust |
| Licencia | Apache-2.0 |
| Rama predeterminada | develop |
| Última versión estable recuperada | v0.44.2 (1 de agosto de 2026) |

El total de commits procede del último enlace de paginación de GET /commits?per_page=1. La métrica watchers_count de la API repite el número de estrellas; por eso aquí se informa subscribers_count como número de suscriptores reales. open_issues_count puede incluir solicitudes de cambios abiertas, de modo que no equivale necesariamente a incidencias de usuarios. Entre quienes más contribuciones aporta la API están aeppling (523), pszymkowiak (215) y FlorianBruniaux (175); la lista es una clasificación del endpoint, no una atribución de autoría.
Cómo lo recibió la comunidad

La recepción pública recuperable es desigual. En Hacker News hay varios envíos directos, pero con conversación limitada:
- Hilo 47189599, enviado por
RyanShookel 28 de febrero de 2026: 18 puntos y 3 comentarios. Es el envío directo de mayor puntuación localizado. - Hilo 46974740, un Show HN de
patrick4urcloudel 11 de febrero de 2026: 4 puntos y 4 comentarios. El mensaje inicial presenta el producto, por lo que acredita difusión y no una reseña independiente. - Hilo 47714995, enviado por
ahamezel 10 de abril: 5 puntos y 2 comentarios.
Se recuperaron los elementos raíz de los dos primeros hilos, pero la escasa discusión no permitió extraer una opinión técnica concreta y atribuible que fuera representativa. Por ello no se convierte la puntuación en entusiasmo generalizado ni se inventa una crítica.
También se localizó en YouTube una búsqueda con tutoriales y demostraciones, incluidos «Claude Code + RTK: Saves 90% Tokens» (vídeo CncyYt9ozAQ), «RTK (Rust Token Killer): Up To 90% Token Savings For Claude Code And Codex» (5p0f2p9Gn0o) y «Herramientas IA #3: Ahorrar tokens con OpenCode, DCP y RTK» (68Bs81B4rJg). No se recuperaron de forma fiable sus canales ni vistas, así que se ofrecen como recursos, no como valoraciones independientes.
Reddit respondió con una página de inicio de sesión al intentar buscar el nombre exacto; no se recuperaron hilos verificables en r/programming, r/selfhosted, r/LocalLLaMA, r/devops, r/netsec o r/MachineLearning. La búsqueda directa en X exige autenticación. La página de Product Hunt recuperada no aportó un lanzamiento verificable. La API de npm devuelve 1.449 descargas semanales para el paquete llamado rtk, pero el README advierte de una colisión de nombre con otro proyecto («Rust Type Kit»); no es una métrica atribuible a este repositorio y se excluye de los números de adopción.
RTK frente a otras propuestas
No se recuperaron comparativas independientes ni benchmarks verificables contra un competidor directo. La comparación técnicamente justificable es con los mecanismos nativos de cada agente: RTK no sustituye al modelo ni al terminal; añade una capa de filtrado antes de que el agente lea la salida. En Claude Code y Cursor puede utilizar ganchos de herramienta; en Codex instala instrucciones; en Hermes instala un adaptador de complemento que muta comandos mediante rtk rewrite.
thehoff/contextcrawler es un derivado, no una alternativa evaluada: su descripción menciona RTK y ContextZip, pero no se recuperó una metodología que permita comparar calidad, seguridad o ahorro. En consecuencia, no hay base para declarar que RTK sea más rápido, más preciso o más económico que otro producto.
Guía rápida de uso
Instalación y primer arranque
En macOS con Homebrew:
brew install rtk
En Linux o macOS, el instalador oficial coloca el binario en ~/.local/bin:
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
rtk --version
rtk gain
También se puede compilar desde el repositorio:
cargo install --git https://github.com/rtk-ai/rtk

El README advierte que cargo install rtk puede instalar otro paquete de crates.io; para este proyecto debe usarse el comando con --git. Tras instalarlo, se elige el adaptador y se reinicia el agente:
rtk init -g # Claude Code o Copilot por defecto
rtk init -g --codex # Codex
rtk init -g --agent cursor # Cursor
rtk init --agent hermes # Hermes
Flujos de trabajo habituales
- Revisar cambios Git:
rtk git status,rtk git diffyrtk git log -n 10devuelven estado, diferencias y confirmaciones condensados. - Localizar un fallo de pruebas:
rtk pytest,rtk cargo testortk test <comando>reducen resultados aprobados y conservan los fallos; si un comando falla, RTK puede dejar la salida completa en~/.local/share/rtk/tee/. - Inspeccionar código o registros extensos:
rtk read file.rs -l aggressive,rtk grep "patrón" .yrtk docker logs <contenedor>priorizan estructura, agrupación y deduplicación. - Medir el uso:
rtk gain --graph,rtk gain --history,rtk discover --all --since 7yrtk sessionmuestran ahorro estimado, oportunidades no cubiertas y adopción reciente.
Configuración esencial
~/.config/rtk/config.toml: configuración principal en Linux; en macOS usa~/Library/Application Support/rtk/config.toml.[hooks].exclude_commands: lista de comandos que no deben reescribirse, por ejemplocurloplaywright.[tee].enabled: conserva salida original al fallar; está activado por defecto.[tee].mode: eligefailures,alwaysoneverpara los archivos de recuperación.RTK_TELEMETRY_DISABLED=1: bloquea telemetría aunque se hubiera dado consentimiento.
Trampas frecuentes y soluciones
- No existe
rtk gaindespués de instalar con Cargo: probablemente se instaló el paquete homónimo; reinstalar concargo install --git https://github.com/rtk-ai/rtk. - No hay reescritura automática: ejecutar
rtk init -g—o el adaptador del agente correspondiente—, usarrtk init --showpara verificarlo y reiniciar el agente. - Un
ReadoGrepinterno de Claude no se comprime: esos instrumentos no atraviesan el gancho de Bash; usarrtk read,rtk grepo comandos de shell. - Windows informa que no encuentra
rg: instalar ripgrep y dejarlo enPATH; el README proponewinget install BurntSushi.ripgrep.MSVC. - Se necesita salida detallada: usar las opciones detalladas del comando o
-v,-vvo-vvv; la filosofía del proyecto exige no sacrificar detalle pedido explícitamente.
Integraciones y migración
RTK se integra mediante ganchos con Claude Code, Copilot, Cursor y Gemini; mediante instrucciones con Codex y Kimi; y mediante complementos o extensiones con OpenCode, OpenClaw, Pi y Hermes. Para Hermes, rtk init --agent hermes instala los archivos de ejecución bajo ~/.hermes/plugins/rtk-rewrite/. No existe una guía de migración desde otro compresor de contexto recuperada en la documentación; la ruta práctica documentada es instalar el adaptador del agente elegido y conservar comandos explícitos rtk cuando se quiera controlar el filtrado.
Cómo contribuir
El proyecto acepta informes, correcciones, filtros nuevos, revisiones y documentación. La guía pide abrir una incidencia clara con pasos de reproducción o una solicitud de cambios focalizada. El flujo documentado es:
git checkout develop
git pull origin develop
git checkout -b feat/scope-your-clear-description
Las ramas usan prefijos fix/, feat/ o chore/; los commits siguen Conventional Commits. Cada cambio debe incluir pruebas y, si afecta comportamiento documentado, documentación. La solicitud debe apuntar a develop, pasar CI y revisión de mantenimiento; la cadena posterior es develop → rama de versión → master. Se exige firmar el CLA mediante el comentario automático de CLA Assistant antes de fusionar contribuciones.
Casos de uso y a quién puede ayudar este repositorio
- Personas que usan agentes de código sobre repositorios grandes: pueden comprimir listados, búsquedas, diferencias y resultados de pruebas antes de que lleguen al contexto del agente.
- Equipos que depuran CI, contenedores o infraestructura: los envoltorios documentados para GitHub CLI, Docker, Kubernetes, AWS y Pulumi reducen progreso repetitivo, conservando fallos y campos esenciales.
- Equipos con varios entornos de agentes: RTK ofrece adaptadores específicos para Claude Code, Codex, Gemini, Cursor, Copilot, OpenCode, Hermes y otros; no obliga a todos a usar la misma interfaz.
- Quien necesite auditoría del efecto:
rtk gain,discoverysessionpermiten revisar el ahorro estimado y los comandos que aún no se filtran. - Quien priorice recuperación ante errores: la opción
teeconserva salida sin filtrar cuando un comando falla, de modo que la compresión no obliga a repetirlo para obtener diagnóstico completo.
Recursos
- Repositorio: github.com/rtk-ai/rtk
- Documentación e instalación: www.rtk-ai.app/guide · README · solución de problemas
- Contribución y cambios: CONTRIBUTING.md · CHANGELOG.md · versiones
- Comunidad/Discord: Discord oficial · Discusiones de GitHub
- Conversaciones y reseñas: HN 47189599 · HN 46974740 · artículo de JetBrains localizado en HN
- Vídeos: Claude Code + RTK · RTK para Claude Code y Codex · OpenCode, DCP y RTK
Nota: este artículo combina la API y el repositorio de GitHub, el sitio oficial, Hacker News, búsquedas de vídeo y comprobaciones de registros realizadas el 6 de agosto de 2026. Las cifras corresponden a ese momento.
Comentarios