TermDeck: El Cockpit del Navegador para Agentes de IA y Terminales

TermDeck es una plataforma local-first diseñada para transformar la experiencia de desarrollo mediante la orquestación de agentes de IA (como Claude Code, Codex o Gemini) y terminales estándar. A diferencia de un emulador de terminal convencional, TermDeck actúa como una capa de gestión que permite manejar múltiples tareas simultáneas en ventanas flotantes dentro del navegador, manteniendo el control total sobre las acciones de la IA sin comprometer la seguridad de los datos.

¿Para quién es TermDeck?

Está diseñado específicamente para desarrolladores y equipos de ingeniería que operan en flujos de trabajo complejos donde:

• Multitarea con IA: Necesitan ejecutar múltiples agentes de IA simultáneamente (ej. un agente para refactorizar, otro para escribir tests y otro para documentación).
• Aislamiento de Contexto: Requieren separar las tareas de la IA en ramas o entornos específicos mediante git worktree para evitar conflictos de archivos.
• Gestión Visual: Buscan una interfaz gráfica (GUI) intuitiva para gestionar procesos de terminal sin abandonar el entorno del navegador.
• Privacidad Estricta: Valoran herramientas que no envíen telemetría ni datos a la nube, manteniendo las claves API en el entorno local.

Funcionalidades Principales y Diferenciadores

• Gestión de Agentes en Paralelo: Cada agente opera en su propia ventana con un git worktree dedicado, permitiendo que múltiples agentes trabajen sobre el mismo repositorio sin sobrescribir cambios entre sí.
• Sistema de Semáforos (Alertas): Interfaz visual que indica el estado del agente: Verde (trabajando), Ámbar (esperando) y Rojo (requiere aprobación humana). El sistema resalta automáticamente la tarea que necesita intervención.
• Persistencia de Sesión con tmux: Integración profunda con tmux para asegurar que las sesiones sobrevivan a reinicios del navegador, fallos del servidor local o desconexiones accidentales.
• Interfaz de Usuario Avanzada: Ventanas flotantes redimensionables, organizadas en cuadrículas mediante una paleta de comandos (⌘K), soporte para temas (Dracula, Nord, Catppuccin) y renderizado acelerado por GPU a través de xterm.js.
• Seguridad Local-First: Ejecución 100% en localhost. No requiere infraestructura externa ni envía datos fuera del entorno local, garantizando que las credenciales de los agentes permanezcan privadas.

Arquitectura y Requisitos Técnicos

TermDeck no es una aplicación web tradicional ni utiliza Electron para su núcleo. Es un proceso de Node.js que levanta terminales reales (PTY) y los sirve a través de WebSockets, lo que reduce drásticamente la sobrecarga de recursos.

• Runtime: Requiere Node.js versión 18 o superior.
• Renderizado: Utiliza xterm.js para una experiencia de terminal fluida y compatible con fuentes personalizadas.
• Dependencias Críticas: node-pty para la gestión de procesos PTY, tmux (recomendado) y git.
• Red y Puertos: Servido localmente en el puerto 3000 por defecto, con validación de origen/host para seguridad.

Instalación y Despliegue

TermDeck está diseñado para una implementación rápida sin pasos de compilación complejos:

1. Ejecución Instantánea: npx @kiril6/termdeck (Ideal para pruebas rápidas sin instalación permanente).
2. Instalación Permanente: npm i -g @kiril6/termdeck (Añade el binario al PATH del sistema para uso diario).
3. Configuración de Hooks: Ejecuta npx @kiril6/termdeck hooks install para integrar soporte específico y estados precisos para Claude Code, Codex, Copilot o Gemini.

Funciones Avanzadas de Productividad

• Broadcast Input: Permite enviar comandos o fragmentos de texto a todas las terminales de un proyecto simultáneamente.
• Window Glue (🔒): Bloquea y une ventanas adyacentes para que se muevan y redimensionen como una sola unidad.
• File & Markdown Viewer: Visor integrado que renderiza archivos .md y permite abrir archivos directamente en el editor predeterminado o en el explorador de archivos del sistema.
• Session Logs: Genera registros automáticos de las sesiones cuando estas finalizan, proporcionando una auditoría completa de las acciones realizadas por los agentes.

Ventajas vs. Alternativas (tmux / iTerm)

Preguntas Frecuentes (FAQ)

¿Es seguro usar TermDeck con mis claves de API?
Sí, ya que el software corre exclusivamente en tu máquina. Las llaves se utilizan por las herramientas CLI locales (como Claude Code), no por la interfaz de TermDeck.

¿Necesito Docker para ejecutarlo?
No es necesario; está diseñado para correr directamente sobre Node.js en tu sistema operativo, aunque puede ser encapsulado en un contenedor si se prefiere una infraestructura aislada.

¿Qué sucede si el navegador se cierra?
Si tienes tmux instalado, la sesión del terminal persistirá y podrás reanudarla inmediatamente al volver a abrir TermDeck.

¿Soporta renderizado por hardware?
Sí, utiliza xterm.js con soporte para GPU, lo que garantiza una respuesta rápida en terminales complejos.

Verificado por HostingByte el 2024. Fuentes: Repositorio Oficial, Documentación Oficial.