Standboy: la extensión de VS Code que convierte el tiempo de espera de tu IA en diversión retro

Standboy es la extensión para VS Code y Cursor que transforma los tiempos muertos de tu agente de IA, como Claude Code o el agente nativo de Cursor, en sesiones de juego retro.

Compatible con Game Boy, Game Boy Color y Game Boy Advance, se activa automáticamente cuando tu IA trabaja y se oculta al terminar, sin perder el progreso. Miles de desarrolladores ya la usan para mantenerse productivos y entretenidos.

5 razones para instalar Standboy hoy

• Aprovecha el tiempo muerto: Convierte los minutos de espera de tu IA en sesiones de juego productivas.
• Sin distracciones externas: Evita caer en redes sociales o pestañas irrelevantes mientras tu agente trabaja.
• 100 por ciento personalizable: Elige entre 5 paletas de colores o crea la tuya, y reasigna los controles a tu gusto.
• Guardados persistentes: Tus progresos en los juegos se guardan automáticamente, incluso al cerrar VS Code.
• Privacidad garantizada: Sin telemetría ni llamadas a servidores externos, excepto para descargar carátulas.

¿Qué es Standboy?

Standboy es una extensión para VS Code y Cursor que integra un emulador de Game Boy directamente en tu editor de código. Cuando tu agente de IA comienza a generar código o realizar tareas, Standboy expande automáticamente un panel lateral con el emulador. Una vez que el agente termina, el emulador se oculta y pausa, retomando exactamente donde lo dejaste la próxima vez que el agente se active.

El objetivo es claro: evitar que el aburrimiento te lleve a pestañas como Twitter, Reddit o Slack, donde el tiempo vuela sin que te des cuenta. Con Standboy, el tiempo de espera se convierte en un momento de diversión controlada, sin salir de tu IDE.

Lo cierto es que Standboy no es solo una herramienta, sino un pequeño oasis de nostalgia en medio del caos del desarrollo de software. ¿Quién no extraña los días de la Game Boy?

¿Cómo funciona?

Standboy se conecta a los hooks de ciclo de vida de tu agente de IA. Esto significa que:

• Se activa automáticamente cuando el agente comienza a trabajar, tras 5 segundos de actividad continua.
• Se oculta automáticamente cuando el agente detiene su actividad, tras 5 segundos de inactividad.
• El emulador pausa y reanuda en el mismo fotograma donde lo dejaste, sin perder progreso.
• Los juegos y guardados persisten incluso después de cerrar VS Code.

Vale la pena señalar que la integración con Claude Code es sorprendentemente fluida: el emulador aparece y desaparece como por arte de magia.

Guía de inicio rápido

Instalación

1. Abre el panel de extensiones en VS Code (Ctrl+Shift+X o Cmd+Shift+X en macOS).

2. Busca Standboy en la barra de búsqueda.

3. Haz clic en Instalar.

Opcional: Si prefieres la terminal, ejecuta este comando:

code --install-extension mfbzme.standboy

Para Cursor y otros forks de VS Code

1. Abre el panel de extensiones.

2. Busca Standboy y haz clic en Instalar.

Nota: Cursor utiliza Open VSX como registro predeterminado.

Primeros pasos

1. Una vez instalada, Standboy se activará automáticamente la primera vez que tu agente de IA comience a trabajar.

2. Haz clic en el botón + Añadir ROM en el panel de Standboy.

3. Selecciona un archivo .gb, .gbc o .gba desde tu disco duro.

4. Standboy copiará el archivo a su biblioteca, lo identificará y comenzará a reproducirlo.

5. La carátula del juego aparecerá en la cuadrícula de la biblioteca unos segundos después.

¿Qué características ofrece Standboy?

Automatización inteligente

• Activación y ocultación automática: Se integra con los hooks nativos de Cursor y Claude Code para detectar cuándo tu agente está activo o inactivo. Si no hay soporte específico para tu agente, usa un sistema de detección basado en ráfagas de edición.
• Reanudación en el mismo fotograma: El estado del emulador se conserva cuando se oculta, por lo que el juego reanuda exactamente donde lo dejaste.
• Biblioteca de ROMs persistente: Las ROMs cargadas se copian en una biblioteca gestionada, y los guardados en el juego se sincronizan con el disco cada vez que el panel se oculta o antes de exportar.

Soporte para múltiples plataformas

• Compatibilidad con Game Boy, Game Boy Color y Game Boy Advance.
• Carga archivos .gb, .gbc y .gba.
• Identificación automática de carátulas y títulos mediante una base de datos No-Intro, el mismo enfoque que usa RetroArch.

Personalización y controles

• 5 paletas de colores predefinidas (kirokaze, dmg, pocket, bgb, mist) + opción para personalizar tu propia paleta con 4 colores hexadecimales.
• Controles de teclado completamente reasignables (flechas para el D-pad, y teclas personalizables para A, B, Start y Select).
• Sin telemetría: No hay llamadas a redes externas, excepto para la descarga de carátulas, que se almacenan en caché localmente.

Detección de agentes de IA

Standboy soporta:

• Claude Code (CLI o extensión de VS Code).
• Agente nativo de Cursor.
• Para otros agentes, como Aider, Cline o GitHub Copilot Edits, utiliza un sistema de detección basado en ráfagas de edición.

¿Cómo usar Standboy por primera vez?

La primera vez que Standboy se activa, el panel se abre automáticamente. Verás:

• Un encabezado vacío con el punto de actividad de Standboy, el espacio para el título de la ROM, el menú (⋯) y el ícono de silencio.
• Un marco en blanco con el texto no cartridge.
• Una tarjeta pequeña que dice Auto-mostrar durante la actividad de IA sobre la cuadrícula de la biblioteca, que te pide conectar el agente detectado (Claude Code o Cursor).
• Una cuadrícula de biblioteca vacía con un botón + Añadir ROM.

Después de conectar tu agente por primera vez, sigue estos pasos:

1. Haz clic en el botón + Añadir ROM (o selecciona Cargar ROM desde el menú).
2. Selecciona un archivo .gb, .gbc o .gba desde tu disco. Standboy lo copiará a tu biblioteca, lo identificará con la base de datos No-Intro y comenzará a reproducirlo.
3. La carátula del juego aparecerá en la cuadrícula de la biblioteca unos segundos después.
4. La próxima vez que abras VS Code, Standboy reanudará automáticamente la última ROM que jugaste, con tus datos de guardado restaurados.

¿Cómo cambiar de ROM?

Haz clic en cualquier carátula en la cuadrícula de la biblioteca para cambiar a esa ROM. La ROM que se está reproduciendo actualmente está resaltada con un anillo verde. Si haces clic en una carátula diferente mientras un juego está en ejecución, aparecerá un mensaje de confirmación.

¿Cómo configurar Standboy?

Puedes personalizar Standboy mediante el menú de configuración (⋯ en la esquina superior derecha del panel). Las opciones incluyen:

• Paleta de colores (standboy.palette): Cambia el esquema de colores del emulador. Ideal si prefieres el estilo clásico de Game Boy (dmg) o algo más moderno (kirokaze).
• Paleta personalizada (standboy.customPalette): Define tus propios 4 colores en formato hexadecimal (ejemplo: ["#FF0000", "#00FF00", "#0000FF", "#FFFF00"]).
• Directorio de la biblioteca (standboy.libraryDirectory): Útil si quieres sincronizar tus ROMs y guardados con servicios como iCloud o Dropbox.
• Auto-mostrar (standboy.autoShow): Desactívalo si prefieres controlar manualmente cuándo aparece el emulador.

Las paletas se aplican en tiempo real, sin necesidad de recargar. Cambiar el directorio de la biblioteca tiene efecto inmediato para nuevas ROMs y guardados. Alternar la opción de auto-mostrar surte efecto en la próxima transición del agente.

¿Dónde se guardan los datos?

Por defecto, la biblioteca de Standboy se encuentra en el directorio globalStorage de VS Code:

• macOS: ~/Library/Application Support/Code/User/globalStorage/mfbzme.standboy/
• Linux: ~/.config/Code/User/globalStorage/mfbzme.standboy/
• Windows: %APPDATA%\Code\User\globalStorage\mfbzme.standboy\

Dentro de esta carpeta, encontrarás:

• library.json: Índice de ROMs (hash, nombre, nombre canónico, extensión, tamaño, fecha de adición, última vez jugado).
• config.json: Configuraciones del usuario (atajos de teclado, preferencias globales).
• roms/: Copias de todas las ROMs que has cargado.
• saves/: Archivos de guardado en el juego.
• covers/: Carátulas en caché (descargadas una vez desde libretro-thumbnails).

¿Qué persiste y qué no?

El estado de Standboy se conserva de la siguiente manera:

• Biblioteca de ROMs y guardados en el juego: Persisten incluso después de reiniciar VS Code o la computadora (si copias la carpeta).
• ROM cargada actualmente (reanudación automática): Persiste después de reiniciar VS Code.
• Estado del emulador a medio fotograma: Se pierde al reiniciar VS Code, pero los guardados en el juego cubren los casos importantes.

¿Cómo hacer una copia de seguridad?

Simplemente copia la carpeta de la biblioteca. Para restaurar, copia la carpeta de vuelta a su ubicación original.

Ejemplo en macOS:

cp -r ~/Library/Application\ Support/Code/User/globalStorage/mfbzme.standboy/ ~/Library/Mobile\ Documents/com~apple~CloudDocs/Standboy/

O cambia la configuración standboy.libraryDirectory para apuntar directamente a una carpeta sincronizada.

¿Cómo solucionar problemas?

Si algo no funciona correctamente, sigue estos pasos:

1. Abre el menú (⋯) y haz clic en Mostrar registros. El canal de salida registra cada transición de estado.
2. Si el panel no se muestra automáticamente durante la actividad del agente, verifica que los hooks estén instalados. Abre el menú (⋯) y ve a Detección para activar tu agente.
3. Si el panel se muestra para cada pequeña acción del agente, ajusta el retraso de visualización (actualmente 5 segundos).
4. Si el audio no funciona, haz clic directamente en la pantalla del juego una vez para activarlo (debido a las políticas de autoplay del navegador).
5. Si el panel se queda en blanco o muestra el punto de carga de Standboy, recarga la ventana (Cmd+Shift+P en macOS o Ctrl+Shift+P en Windows/Linux, luego selecciona Developer: Reload Window).
6. Si desinstalaste Standboy pero el agente parece más lento, elimina manualmente las entradas de los hooks en ~/.claude/settings.json y ~/.cursor/hooks/hooks.json que contengan marker.cjs.

Si el problema persiste, consulta la sección de problemas en GitHub.

¿Standboy es legal?

Standboy no está afiliado, respaldado ni patrocinado por Nintendo Co., Ltd. Game Boy, Game Boy Color y Game Boy Advance son marcas registradas de Nintendo.

Este proyecto es de código abierto y no distribuye, enlaza ni promueve la descarga de ROMs con derechos de autor. El usuario es responsable de asegurar que sus ROMs sean legales.

¿Qué licencia usa Standboy?

Standboy se distribuye bajo la licencia MIT.

Preguntas frecuentes sobre Standboy

¿Por qué los desarrolladores amamos Standboy?

Standboy no solo es una herramienta útil, sino que también aporta un toque de nostalgia y diversión al flujo de trabajo. Es una forma de mantener la mente activa y entretenida durante los tiempos de espera, sin salir del entorno de desarrollo.

¿Cómo afecta Standboy al rendimiento de mi IDE?

Standboy está optimizado para funcionar en segundo plano sin afectar el rendimiento de VS Code o tu agente de IA. El emulador solo consume recursos cuando el panel está visible y activo.

¿Puedo usar ROMs de juegos comerciales?

Standboy no incluye ni distribuye ROMs. Debes usar tus propias ROMs obtenidas legalmente. La extensión es compatible con archivos .gb, .gbc y .gba.

¿Funciona Standboy en Linux o Windows?

Sí. Standboy es compatible con macOS, Linux y Windows, siempre que tengas instalado VS Code o un fork como Cursor.

¿Cómo desinstalo Standboy?

1. Desactiva la detección de agentes en el menú de Standboy (⋯ → Detección → Apagar).

2. Desinstala la extensión desde el panel de extensiones de VS Code.

3. Opcional: Elimina la carpeta de la biblioteca si quieres borrar tus ROMs y guardados.