DragoTerminal: 34 herramientas y 59 juegos en una terminal Matrix

DragoTerminal es una app Flutter para Android que reúne 34 herramientas técnicas —SSH, bases de datos, red, ficheros, IA, multimedia y utilidades de desarrollo— junto a un arcade de 59 juegos que funcionan sin conexión, todo bajo una misma interfaz con estética de terminal: fondo negro, FiraCode, lluvia Matrix y transiciones de CRT.

La filosofía es local-first: todo lo esencial funciona sin cuenta y sin servidor, y las credenciales sensibles se guardan cifradas en el propio dispositivo. La cuenta es opcional; sirve para sincronizar con la web y para las funciones que de verdad necesitan servidor, como Encuestas y Biblioteca.

El proyecto empezó en enero de 2026 con otro nombre, SSH Tunnel DB Manager, para resolver algo que yo necesitaba: conectarme desde el móvil a bases de datos MySQL o PostgreSQL remotas a través de un túnel SSH y poder ver y editar los datos, algo que en Android no tenía una solución cómoda.

Aquel primer README admitía que el túnel era «una implementación simplificada». Hoy es port-forwarding local de verdad: la app abre un socket local, multiplexa cada conexión hacia el servidor y apunta la huella de su clave la primera vez; si un día cambia, corta la conexión. El gestor de bases de datos trabaja encima con naturalidad. A partir de ahí, la app fue creciendo herramienta a herramienta hasta convertirse en una navaja suiza.

Las herramientas viven en un registro declarativo con 9 categorías —conexiones, IA, nube personal, multimedia, archivos, red, ubicación, dispositivo y dev tools— y el menú se adapta a cada uno: se pueden reordenar por arrastre, ocultar las que no uses y buscarlas todas desde un buscador global que ignora acentos.

Hay de todo: editor de documentos PDF y Excel, editor de fotos y EXIF, creador de stickers para WhatsApp, sonómetro y afinador por FFT, escáner y generador de QR, GPS simulado con rutas y joystick, recordatorios programados, arte ASCII y un generador de tonos de 20 Hz a 20 kHz. El chat de IA también sabe hablar con un servidor Ollama de tu red, el mismo motor que uso en DRAGO Model Runner.

Los 59 juegos se reparten en cuatro categorías —11 arcade, 6 de puzle, 6 de mesa y 36 minijuegos rápidos— y comparten un mismo armazón: un shell que aporta el marcador, el récord persistente, los estados de pausa y fin de partida y la hoja de cómo se juega. Cada juego solo implementa su bucle; añadir uno nuevo es crear su pantalla y una línea en el registro.

El historial lo demuestra: el arcade entró en la app el 11 de junio con 12 juegos y once días después ya tenía 59. Así es como una sola persona mantiene desde un snake hasta un ajedrez completo, cuyo minimax corre en un isolate —igual que el de las damas y el reversi— para no congelar la interfaz. Los seis juegos de mesa y el Pong tienen modo contra la CPU, con marcador de victorias, derrotas y empates.

Varias piezas necesitaron código nativo Android: el GPS simulado corre como servicio en primer plano con su gestor de ubicaciones simuladas, el generador de tonos sintetiza el audio en Kotlin, los packs de stickers se exponen a WhatsApp mediante un content provider propio, y hay un widget de pantalla de inicio con la frase del día. Existe incluso un módulo independiente para Wear OS: una Tile que muestra la misma frase en el reloj.

Subir a Google Play también obligó a bajar al build. El escáner de QR arrastraba librerías nativas alineadas a páginas de 4 KB, y Play exige que funcionen con páginas de 16 KB. La solución fue forzar en Gradle las versiones de cámara y ML Kit que Google ya había recompilado, y empaquetar las librerías nativas sin comprimir.

La frase del día se calcula indexando una lista por los días transcurridos desde el año 2000, módulo el número de frases. Como el cálculo es determinista, la app, el widget del escritorio y la Tile del reloj —que ni siquiera embebe Flutter— muestran la misma frase el mismo día sin hablar entre ellos ni con ningún servidor. La solución más simple resultó ser también la más robusta.

Nada del arranque depende de la red: las sincronizaciones se lanzan en segundo plano y el menú se pinta sin esperar a ningún servidor. Las credenciales sensibles —perfiles SSH, conexiones guardadas, claves de API, secretos 2FA— viven cifradas en el almacén seguro del sistema, y una migración única sacó de las preferencias en texto plano las que habían guardado versiones antiguas.

Con la sesión iniciada, la cuenta suma sincronización: el orden y las herramientas ocultas del menú, los récords de los juegos, el portapapeles si lo activas y los perfiles de conexión. Encuestas —formularios con enlace público que cualquiera puede responder— y Biblioteca —un chat personal de notas y archivos— forman la sección Nube personal y viven directamente de esa cuenta: lo que creas en la app aparece en la web, y al revés.

Al principio DragoTerminal tuvo su propio servidor: un FastAPI con PostgreSQL y Redis en Docker, con 15 routers y 86 endpoints. En junio de 2026 decidí no mantener dos backends y consolidarlo todo en el de esta web: un único FastAPI bajo /api/v1, con los mismos usuarios y contraseñas en la app y en el navegador. Los endpoints que usaba la app se portaron a 13 routers dentro de ese backend, y el servidor original quedó congelado como referencia.

La pieza que hace posible la simbiosis es la autenticación. En el backend, una sola función resuelve el usuario a partir de la cookie de sesión de la web, de un token Bearer o de una cabecera X-API-Key, cuya clave se guarda solo como hash; cualquier endpoint que la use sirve igual a los dos clientes. En la app, la forma de autenticarse es una estrategia intercambiable —token o clave API— y la clave vive en el almacén seguro, así que el cambio de backend no obligó a tocar ninguna llamada existente.

Compartir backend tiene un riesgo que un servidor propio escondía: un error de sincronización ya no se queda en tu móvil. La auditoría de agosto encontró justo eso: al sincronizar credenciales SSH, de bases de datos y de Firebase, la app usaba la posición en la lista local como identificador en el servidor, así que una edición o un borrado podía caer sobre un registro que no le tocaba.

El arreglo dejó tres reglas que hoy son convención del proyecto: las actualizaciones y los borrados remotos van siempre por el identificador del servidor, la fusión es aditiva y conserva los secretos locales, y una respuesta dudosa nunca sobrescribe la caché local —una lista donde se esperaba un objeto llegó a vaciarla—. Lo vigilan 21 tests propios.

El proyecto suma 140.801 líneas de Dart en 220 ficheros, escritas entre enero y agosto de 2026. La 2.1.4, la versión que está en Google Play desde el 21 de agosto, salió con el análisis estático limpio y 190 tests en verde, entre ellos un smoke test por cada uno de los 36 minijuegos rápidos. El proyecto se ha auditado internamente y las incidencias graves están corregidas.

Las deudas también están dichas: ningún juego tiene sonido todavía, la accesibilidad está pendiente con un plan por fases, no hay integración continua —el análisis y los tests se lanzan a mano— y, aunque Flutter es multiplataforma, en la práctica todo el código nativo es de Android.