Repolode
Enviar
onesuper

onesuper/tui-use

Una CLI que permite a los agentes de IA controlar programas interactivos de terminal, como REPL, depuradores y aplicaciones TUI, mediante una PTY.

Ver en GitHub
Estrellas
270
Forks
25
Issues abiertos
2
Último commit
hace 6 meses

¿Qué es?

tui-use es una herramienta de línea de comandos que permite a los agentes de IA trabajar con programas que esperan que alguien use el teclado. Inicia un programa dentro de una pseudo-terminal, renderiza su salida mediante un emulador de xterm sin interfaz gráfica y muestra la pantalla actual como texto plano limpio. Después, un agente puede enviar pulsaciones de teclas, leer el resultado y decidir qué hacer a continuación.

La herramienta está pensada para situaciones en las que los comandos de shell habituales no bastan, como una sesión de Python o pdb que mantiene un gran estado en memoria, una sesión de depuración de GDB, un REPL de Node o aplicaciones a pantalla completa como vim, lazygit, htop y fzf. Un daemon mantiene activas las sesiones de PTY entre distintas llamadas a la CLI, por lo que el proceso no tiene que reiniciarse entre pasos.

En lugar de esperar y consultar repetidamente, el comando `wait` termina cuando la pantalla se mantiene estable durante un periodo de inactividad configurable o cuando aparece un patrón de texto determinado. Cada captura también muestra las zonas resaltadas en vídeo inverso, que indican el elemento activo del menú o la pestaña seleccionada. Se instala mediante npm y el proyecto incluye paquetes de plugins para Claude Code y OpenAI Codex.

Funciones clave

  • 01Ejecuta cualquier programa en una PTY y renderiza su salida con un emulador de xterm sin interfaz gráfica.
  • 02Proporciona capturas de pantalla en texto plano, opcionalmente en formato JSON.
  • 03Espera a que la pantalla se estabilice o aparezca un patrón de texto específico.
  • 04Indica los segmentos resaltados en vídeo inverso para que los agentes puedan ver la selección activa.
  • 05Mantiene las sesiones activas entre llamadas a la CLI mediante un daemon en segundo plano.
  • 06Admite escribir, pegar, pulsar teclas especiales, desplazarse y buscar expresiones regulares en la pantalla.

Casos de uso

  • Depurar una sesión de Python de larga duración sin perder su estado en memoria.
  • Controlar puntos de interrupción de GDB o pdb e inspeccionar variables desde un agente.
  • Permitir que un agente de programación con IA navegue por herramientas a pantalla completa como vim o lazygit.
  • Ejecutar sesiones REPL interactivas en las que cada paso depende de la salida anterior.

Inicio rápido

  1. 1

    Instala la CLI desde npm

    npm install -g tui-use
  2. 2

    Inicia un programa en una sesión PTY

    tui-use start python3 examples/ask.py
  3. 3

    Espera a que la pantalla se estabilice, escribe una respuesta y pulsa Enter

    tui-use wait
  4. 4

    Toma una captura de la pantalla actual

    tui-use snapshot

Antes de usarlo

  • Se eliminan los colores y la mayoría del formato del texto de la salida de pantalla; solo se conservan los resaltados, el título y el estado de pantalla completa.
  • Es necesario instalar la CLI por separado antes de que funcionen los plugins de Claude Code o Codex.

Temas

#terminal#cli#pty#ai-agents#repl#debugging#tui

Preguntas frecuentes

¿Qué es tui-use?
Una CLI que permite a los agentes de IA controlar programas interactivos de terminal, como REPL, depuradores y aplicaciones TUI, mediante una PTY. tui-use es una herramienta de línea de comandos que permite a los agentes de IA trabajar con programas que esperan que alguien use el teclado. Inicia un programa dentro de una pseudo-terminal, renderiza su salida mediante un emulador de xterm sin interfaz gráfica y muestra la pantalla actual como texto plano limpio. Después, un agente puede enviar pulsaciones de teclas, leer el resultado y decidir qué hacer a continuación.
¿tui-use es gratuito? ¿Qué licencia tiene?
tui-use es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿tui-use sigue mantenido?
Sin commits en más de 6 meses. El último commit de tui-use fue el 11 abr 2026.
¿Para qué puedo usar tui-use?
Depurar una sesión de Python de larga duración sin perder su estado en memoria. Controlar puntos de interrupción de GDB o pdb e inspeccionar variables desde un agente. Permitir que un agente de programación con IA navegue por herramientas a pantalla completa como vim o lazygit. Ejecutar sesiones REPL interactivas en las que cada paso depende de la salida anterior.
¿Cómo se instala tui-use?
Instala la CLI desde npm: npm install -g tui-use Inicia un programa en una sesión PTY: tui-use start python3 examples/ask.py Espera a que la pantalla se estabilice, escribe una respuesta y pulsa Enter: tui-use wait Toma una captura de la pantalla actual: tui-use snapshot
¿Dónde consigo tui-use?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/onesuper/tui-use

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados