Repolode
Enviar
openclaw

openclaw/Peekaboo

CLI y app de barra de menús para macOS que captura pantallas y ventanas de apps, inspecciona elementos de la interfaz y automatiza clics y escritura para agentes de IA o clientes MCP.

Ver en GitHubSitio web
Estrellas
5,352
Forks
411
Issues abiertos
9
Último commit
hace 8 horas

¿Qué es?

Peekaboo es una herramienta de línea de comandos y una app de barra de menús para macOS que permite capturar pantallas, inspeccionar la accesibilidad y automatizar la interfaz nativa. Un flujo de trabajo habitual consiste en observar la pantalla actual, seleccionar un elemento de un mapa estructurado de la interfaz mediante identificadores opacos y actuar sobre él con clics, escritura, pulsaciones de teclas, desplazamiento o comandos de menú.

Además de su uso directo desde la CLI, Peekaboo incluye un agente que planifica tareas de varios pasos a partir de instrucciones en lenguaje natural y un servidor MCP que ofrece las mismas herramientas a clientes como Codex, Claude Code y Cursor. Las capturas de pantalla se pueden enviar a modelos de IA locales o remotos configurados para responder preguntas visuales. También se puede enviar entrada dirigida a una ventana específica en segundo plano, sin que la app de destino tenga que pasar a primer plano.

La CLI y la app requieren macOS 15 o posterior, y para compilar desde el código fuente se necesitan Swift 6.2 y Node.js 22. Antes de usarlo, hay que conceder los permisos de Grabación de pantalla y Accesibilidad.

Funciones clave

  • 01Captura toda la pantalla, una sola app o una ventana específica en archivos PNG.
  • 02Crea un mapa estructurado de la interfaz de las apps en ejecución, con identificadores para seleccionar elementos.
  • 03Hace clic, escribe, pulsa teclas, desplaza y arrastra sobre elementos o ventanas específicos.
  • 04Ejecuta un agente que convierte solicitudes en lenguaje natural en acciones de varios pasos.
  • 05Ofrece sus herramientas a clientes de IA mediante un servidor MCP.
  • 06Permite enviar entradas en segundo plano a ventanas específicas.

Casos de uso

  • Permitir que un agente de IA use apps nativas de macOS como Safari o Finder.
  • Automatizar clics y entrada de texto repetitivos en software de escritorio sin API de scripting.
  • Capturar pantallas de apps o ventanas para documentación, pruebas o informes de errores.
  • Dar a un asistente de programación compatible con MCP la capacidad de inspeccionar y verificar el estado de la interfaz.

Inicio rápido

  1. 1

    Instala la CLI con Homebrew

    brew install openclaw/tap/peekaboo
  2. 2

    Comprueba los permisos que tiene Peekaboo

    peekaboo permissions status
  3. 3

    Haz una captura de pantalla

    peekaboo see --no-elements --mode screen --path /tmp/peekaboo-screen.png
  4. 4

    Inspecciona una aplicación en ejecución para obtener un mapa estructurado de la interfaz

    peekaboo see --app Finder --json

Antes de usarlo

  • Requiere macOS 15 o posterior, por lo que no funciona en Windows ni Linux.
  • Debes conceder manualmente los permisos de grabación de pantalla y accesibilidad para que funcione correctamente.
  • Para ejecutar agentes, debes configurar un proveedor de modelos.

Temas

#macos#screenshots#automation#mcp#accessibility#swift#ai-agent#ai

Preguntas frecuentes

¿Qué es Peekaboo?
CLI y app de barra de menús para macOS que captura pantallas y ventanas de apps, inspecciona elementos de la interfaz y automatiza clics y escritura para agentes de IA o clientes MCP. Peekaboo es una herramienta de línea de comandos y una app de barra de menús para macOS que permite capturar pantallas, inspeccionar la accesibilidad y automatizar la interfaz nativa. Un flujo de trabajo habitual consiste en observar la pantalla actual, seleccionar un elemento de un mapa estructurado de la interfaz mediante identificadores opacos y actuar sobre él con clics, escritura, pulsaciones de teclas, desplazamiento o comandos de menú.
¿Peekaboo es gratuito? ¿Qué licencia tiene?
Peekaboo es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Peekaboo sigue mantenido?
Mantenimiento activo. El último commit de Peekaboo fue el 20 oct 2026.
¿Para qué puedo usar Peekaboo?
Permitir que un agente de IA use apps nativas de macOS como Safari o Finder. Automatizar clics y entrada de texto repetitivos en software de escritorio sin API de scripting. Capturar pantallas de apps o ventanas para documentación, pruebas o informes de errores. Dar a un asistente de programación compatible con MCP la capacidad de inspeccionar y verificar el estado de la interfaz.
¿Cómo se instala Peekaboo?
Instala la CLI con Homebrew: brew install openclaw/tap/peekaboo Comprueba los permisos que tiene Peekaboo: peekaboo permissions status Haz una captura de pantalla: peekaboo see --no-elements --mode screen --path /tmp/peekaboo-screen.png Inspecciona una aplicación en ejecución para obtener un mapa estructurado de la interfaz: peekaboo see --app Finder --json
¿Dónde consigo Peekaboo?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/openclaw/Peekaboo

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

Proyectos relacionados