Una poderosa habilidad de automatización de terminal que permite a los AI agents operar, interactuar y verificar programas TUI como vim, htop y nano a través del CLI tui-agent.
Instalar y Descargar
1. ClawHub CLI
La forma más rápida de instalar una habilidad directamente desde el registro.
npx clawhub@latest install tui-use
2. Instalación manual
Copia la carpeta de la habilidad a una de estas ubicaciones
~/.openclaw/skills/ <project>/skills/ Prioridad: Espacio de trabajo > Local > Integrado
3. Instalación del prompt
Copia este prompt en OpenClaw para instalarlo automáticamente.
Ayúdame a instalar tui-use usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).
¿Prefieres descargar?
Obtén los archivos originales de la habilidad en un archivo ZIP.
¿Qué es tui-use?
La habilidad tui-use proporciona un puente robusto entre AI agents y aplicaciones de Terminal User Interface (TUI). Al aprovechar la herramienta CLI tui-agent, permite un control sofisticado sobre programas basados en terminal que normalmente requieren interacción humana, como editores de texto (vim, nano, emacs), monitores de sistema (htop, btop) y administradores de archivos (ranger, mc). Esta extensión de Openclaw Skills actúa como los 'ojos y manos' del agent, proporcionando retroalimentación visual a través de capturas de pantalla y la capacidad de enviar comandos precisos de teclado, clics de mouse y comandos de desplazamiento.
Construido sobre una arquitectura basada en daemon, tui-use gestiona una pantalla virtual (pyte) y una sesión PTY para asegurar que las aplicaciones ncurses complejas se rendericen correctamente. Esto permite una automatización confiable de flujos de trabajo de terminal, incluyendo tareas de edición en varios pasos, monitoreo del sistema e interacciones con clientes de bases de datos, todo manteniendo el estado a través de un ciclo de vida basado en sesiones.
Casos de uso de tui-use
- Automatizar ediciones de archivos en editores basados en terminal como vim o nano cuando el acceso directo al sistema de archivos no es suficiente.
- Monitoreo del sistema en tiempo real y gestión de procesos utilizando herramientas como htop o top.
- Interactuar con clientes de bases de datos basados en ncurses (mycli, pgcli) para tareas administrativas.
- Navegar y operar administradores de archivos de terminal como midnight commander o ranger.
- Automatizar flujos de trabajo de terminal heredados que requieren secuencias de teclado específicas y verificación visual.
Cómo funciona tui-use
- Inicialización de la Sesión: El agent inicia una sesión nombrada usando tui-agent, que genera el programa TUI dentro de un terminal virtual.
- Sincronización de Estado: Se emite un comando 'wait' para asegurar que el programa ha terminado de renderizarse o ha alcanzado un estado de texto específico.
- Captura Visual: El agent captura el estado actual de la pantalla (incluidas las coordenadas del cursor) para comprender el diseño y el contexto del TUI.
- Ejecución de Interacción: Basado en los datos visuales, el agent envía comandos específicos: 'type' para caracteres imprimibles, 'key' para teclas de función especiales, o acciones de mouse.
- Bucle de Verificación: Después de cada acción, se realiza una nueva captura o diff para verificar que el programa reaccionó como se esperaba.
- Limpieza: Una vez que la tarea está completa, la sesión se detiene formalmente para liberar los recursos del terminal.
Configuración de tui-use
Para usar esta capacidad de Openclaw Skills, debes tener el CLI tui-agent instalado en tu entorno. Sigue estos pasos:
- Clona el repositorio y navega al directorio tui-agent.
- Instala el paquete en modo editable:
pip install -e tui-agent\/
- Verifica la instalación listando las sesiones activas:
tui-agent list
Esquema de datos y taxonomía de tui-use
La habilidad gestiona datos del terminal a través de sesiones estructuradas y snapshots. La siguiente tabla describe cómo se organizan los datos:
| Componente | Descripción |
|---|---|
| Nombre de la Sesión | Un identificador único (ej: editor) utilizado para enrutar comandos a instancias PTY específicas. |
| Captura de Pantalla | Una representación basada en texto de la cuadrícula del terminal, a menudo incluyendo el procesamiento de ANSI escape sequence. |
| Snapshots | Estados de pantalla nombrados guardados en disco para pruebas de regresión visual y operaciones de diff. |
| Scrollback | Un búfer que contiene la salida histórica del terminal que se ha movido fuera del área activa de la pantalla. |
| Metadatos | Incluye dimensiones del terminal (rows/cols), posición del cursor (row/col) y códigos de salida de sesión. |
Funciones avanzadas de tui-use
- Modo de Pegado entre Corchetes: Usa el comando
pastepara insertar de forma segura bloques de código de varias líneas en editores sin activar atajos de comandos no deseados. - Monitoreo de Estabilidad: Implementa esperas
--stableque pausan la ejecución hasta que la pantalla del terminal deja de cambiar durante una duración especificada. - Regresión Visual: Usa el comando
diffpara comparar el estado del terminal en vivo contra unsnapshotguardado para una automatización de alta precisión. - Captura Regional: Enfócate en coordenadas específicas del terminal usando
--top,--left,--heighty--widthpara reducir el uso de tokens y el ruido. - PTY Daemonizado: La gestión automática de daemon en segundo plano asegura que las sesiones de terminal persistan incluso si el proceso principal del agent fluctúa.
SKILL.md
Cargando
Habilidades relacionadas de Openclaw
Habilidad de traducción automática trilingüe
Una habilidad de AI agent que adjunta automáticamente traducciones en inglés y japonés a cada respuesta en chino generada.
Experto en Pre-Revisión de Requisitos
Una herramienta de análisis profesional que revisa sistemáticamente los documentos de requisitos desde las perspectivas de negocio, desarrollo y pruebas para identificar brechas y riesgos.
Guía de la marca Longchamp
Una habilidad de inteligencia técnica que proporciona conocimientos profundos sobre la historia de la marca Longchamp, la taxonomía de productos y la artesanía de cuero francesa.
Junqi Dark Layout
Un generador de diseños sofisticado para Ajedrez Militar Chino que combina estrategia impulsada por LLM con validación automática de reglas en Python y renderizado de imágenes mediante Openclaw Skills.
Team Agents Orchestrator
Un sofisticado marco de orquestación para agentes de IA que impone una estricta separación de roles y handoffs estructurados para garantizar una ejecución de tareas de alta calidad.
MemDDC
MemDDC es una herramienta inteligente diseñada para la gestión de documentación de proyectos en equipo y el desarrollo iterativo de código, con generación automática de documentos y mapeo de modelos DDD.
METADATA
Presentado*
