rtk-ai__rtk/README_es.md

Proxy CLI de alto rendimiento que reduce el consumo de tokens LLM en un 60-90%

Sitio web • Instalar • Solucion de problemas • Arquitectura • Discord

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

---

rtk filtra y comprime las salidas de comandos antes de que lleguen al contexto de tu LLM. Compatible con cualquier agente de codigo IA — solo prefija los comandos con rtk. Binario unico, cero dependencias, <10ms de overhead.

Ahorro de tokens (sesion de desarrollo de 30 min)

Operacion	Frecuencia	Estandar	rtk	Ahorro
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%
Total		~118,000	~23,900	-80%

Instalacion

Homebrew (recomendado)

brew install rtk

Instalacion rapida (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

Verificacion

rtk --version   # Debe mostrar "rtk 0.27.x"
rtk gain        # Debe mostrar estadisticas de ahorro

Inicio rapido

Uso directo con cualquier agente:

rtk git status              # Estado compacto
rtk cargo test              # Solo fallos (-90%)
rtk grep "pattern" .        # Resultados agrupados

O reescritura automatica con Claude Code:

rtk init --global           # Instalar hook
# Reiniciar Claude Code — los comandos se reescriben automaticamente
git status                  # → rtk git status (transparente)

RTK es un binario autonomo. El hook de Claude Code reescribe los comandos automaticamente, pero cualquier agente funciona prefijando rtk.

Como funciona

  Sin rtk:                                         Con rtk:

  Agent  --git status-->  shell  -->  git           Agent  --git status-->  RTK  -->  git
    ^                                   |             ^                      |          |
    |        ~2,000 tokens (crudo)      |             |   ~200 tokens        | filtro   |
    +-----------------------------------+             +------- (filtrado) ---+----------+

Cuatro estrategias:

1. Filtrado inteligente - Elimina ruido (comentarios, espacios, boilerplate)
2. Agrupacion - Agrega elementos similares (archivos por directorio, errores por tipo)
3. Truncamiento - Mantiene contexto relevante, elimina redundancia
4. Deduplicacion - Colapsa lineas de log repetidas con contadores

Comandos

Archivos

rtk ls .                        # Arbol de directorios optimizado
rtk read file.rs                # Lectura inteligente
rtk find "*.rs" .               # Resultados compactos
rtk grep "pattern" .            # Busqueda agrupada por archivo

Git

rtk git status                  # Estado compacto
rtk git log -n 10               # Commits en una linea
rtk git diff                    # Diff condensado
rtk git push                    # -> "ok main"

Tests

rtk test cargo test             # Solo fallos (-90%)
rtk vitest run                  # Vitest compacto
rtk pytest                      # Tests Python (-90%)
rtk go test                     # Tests Go (-90%)

Build & Lint

rtk lint                        # ESLint agrupado por regla
rtk tsc                         # Errores TypeScript agrupados
rtk cargo build                 # Build Cargo (-80%)
rtk ruff check                  # Lint Python (-80%)

Analiticas

rtk gain                        # Estadisticas de ahorro
rtk gain --graph                # Grafico ASCII (30 dias)

Solo Claude Code (lee archivos de sesion de ~/.claude/projects/):

rtk discover                    # Oportunidades perdidas en el historial de sesiones
rtk discover --all --since 7    # Todos los proyectos, ultimos 7 dias
rtk learn                       # Correcciones CLI aprendidas del historial de errores
rtk cc-economics                # Analisis de costes de tokens por sesion Claude Code

Proximamente: rtk discover para Aider, Cline, Goose e historial shell (cualquier agente). Seguir #273.

Documentacion

• TROUBLESHOOTING.md - Resolver problemas comunes
• INSTALL.md - Guia de instalacion detallada
• ARCHITECTURE.md - Arquitectura tecnica

Contribuir

Las contribuciones son bienvenidas. Abre un issue o PR en GitHub.

Unete a la comunidad en Discord.

Licencia

Licencia MIT - ver LICENSE para detalles.

Descargo de responsabilidad

Ver DISCLAIMER.md.