Repolode
Enviar
govijr

govijr/terminal-mac

Una máquina virtual de macOS que los agentes de IA controlan mediante herramientas MCP y se visualiza en la terminal con los gráficos de Kitty, Ghostty o iTerm2.

Ver en GitHub
Estrellas
2,111
Forks
132
Issues abiertos
1
Último commit
hace 15 horas

¿Qué es?

terminal-mac ejecuta un sistema invitado real de macOS en Apple silicon mediante el framework Virtualization de Apple. Una app auxiliar dentro del sistema invitado captura su pantalla y envía eventos de teclado y mouse, para que los agentes puedan usar ese Mac separado sin mover el puntero del Mac físico ni acceder a su portapapeles. El sistema invitado tiene sus propias apps, archivos y cuentas, y no hereda las sesiones iniciadas en el host.

Un visor de terminal muestra la pantalla del sistema invitado en línea mediante los gráficos de Kitty, Ghostty o iTerm2, y permite escribir, hacer clic, arrastrar, desplazarse y usar una paleta de atajos de Mac. Los comandos para agentes se ofrecen como herramientas MCP (screenshot, click, drag, scroll, type, key, status), junto con una skill que describe un ciclo de observar, actuar y verificar. La CLI se ocupa de descargar la imagen de restauración, crear e iniciar la VM y ejecutar comandos de ciclo de vida, como pausar, reanudar y detener.

El proyecto está en una fase temprana, como candidato a lanzamiento. Durante la configuración inicial, se deben conceder de forma interactiva los permisos de Screen Recording y Accessibility al sistema invitado, y la VM no está aislada de la red de forma predeterminada.

Funciones clave

  • 01Ejecuta un sistema invitado real de macOS en Apple silicon, con sus propias apps, archivos y cuentas.
  • 02Muestra la pantalla del sistema invitado en línea en terminales Kitty, Ghostty o iTerm2.
  • 03Ofrece screenshot, click, drag, scroll, type, key y status como herramientas MCP.
  • 04La entrada del agente no mueve el puntero del host ni modifica su portapapeles.
  • 05Se instala mediante un script de curl y descarga la imagen de restauración de macOS en el primer inicio.
  • 06Ofrece una paleta de atajos de Mac, accesible con Ctrl+G, para las teclas que la terminal no puede enviar directamente.

Casos de uso

  • Permitir que un agente de IA use apps exclusivas de macOS sin tomar el control del escritorio propio.
  • Probar software de interfaz gráfica de macOS en un Mac virtual aislado.
  • Ver o controlar un Mac virtual desde una terminal en sesiones locales sin SSH.
  • Realizar experimentos con agentes que usan la computadora y necesitan un entorno de macOS desechable.

Inicio rápido

  1. 1

    Instala con el instalador de curl del README (verifica SHA-256)

  2. 2

    Sigue la configuración guiada para descargar, instalar e iniciar un Mac virtual

    terminal-mac up
  3. 3

    Conecta un agente de IA a través de MCP

    claude mcp add terminal-mac -- terminal-mac mcp

Antes de usarlo

  • Requiere un Mac con Apple silicon que ejecute macOS 14 o posterior.
  • Es una versión candidata inicial; aún están pendientes las pruebas de aceptación del invitado en un Mac limpio.
  • Las versiones están autofirmadas y Apple no las ha notarizado.
  • El visor en línea solo funciona en Ghostty, Kitty o iTerm2.

En colecciones

Frameworks y apps de agentes de IA open sourceServidores MCPHerramientas de CLI y terminalApps open source para Mac

Temas

#macos#virtualization#computer-use#mcp#ai-agent#terminal#swift#apple-silicon

Preguntas frecuentes

¿Qué es terminal-mac?
Una máquina virtual de macOS que los agentes de IA controlan mediante herramientas MCP y se visualiza en la terminal con los gráficos de Kitty, Ghostty o iTerm2. terminal-mac ejecuta un sistema invitado real de macOS en Apple silicon mediante el framework Virtualization de Apple. Una app auxiliar dentro del sistema invitado captura su pantalla y envía eventos de teclado y mouse, para que los agentes puedan usar ese Mac separado sin mover el puntero del Mac físico ni acceder a su portapapeles. El sistema invitado tiene sus propias apps, archivos y cuentas, y no hereda las sesiones iniciadas en el host.
¿terminal-mac es gratuito? ¿Qué licencia tiene?
terminal-mac es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿terminal-mac sigue mantenido?
Mantenimiento activo. El último commit de terminal-mac fue el 6 nov 2026.
¿Para qué puedo usar terminal-mac?
Permitir que un agente de IA use apps exclusivas de macOS sin tomar el control del escritorio propio. Probar software de interfaz gráfica de macOS en un Mac virtual aislado. Ver o controlar un Mac virtual desde una terminal en sesiones locales sin SSH. Realizar experimentos con agentes que usan la computadora y necesitan un entorno de macOS desechable.
¿Cómo se instala terminal-mac?
Instala con el instalador de curl del README (verifica SHA-256) Sigue la configuración guiada para descargar, instalar e iniciar un Mac virtual: terminal-mac up Conecta un agente de IA a través de MCP: claude mcp add terminal-mac -- terminal-mac mcp
¿Dónde consigo terminal-mac?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/govijr/terminal-mac

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

Proyectos relacionados