Repolode
franzenzenhofer

franzenzenhofer/big-arrow-on-the-screen

CLI de macOS y skill para agentes de IA que dibuja flechas, recuadros y letreros grandes en pantalla para señalar elementos de la interfaz, sin hacer clic ni capturar nada.

Estrellas
784
Forks
24
Issues abiertos
4
Último commit
anteayer

¿Qué es?

bigarrow es una herramienta de línea de comandos para macOS, escrita en Swift, que dibuja una flecha con un letrero por encima de todas las ventanas, en todas las pantallas y Spaces. Los clics atraviesan la superposición, el foco del teclado se mantiene donde estaba y la flecha se elimina al cumplirse un límite de tiempo, cuando termina el proceso del agente que la creó o cuando el usuario la detiene.

Su uso principal es permitir que los agentes de IA señalen algo en pantalla a una persona, como una solicitud de permisos, un botón que debe presionar o un paso de 2FA que el agente no puede completar por sí mismo. Los objetivos se pueden indicar mediante coordenadas, nombres de ventanas o aplicaciones, o etiquetas de elementos de la interfaz encontradas a través de la Accessibility API. La herramienta nunca hace clic, escribe ni captura la pantalla.

Se distribuye como un único binario, sin daemon, icono en la barra de menús ni cuenta, y se puede instalar mediante Homebrew. Un instalador de skills añade instrucciones para Claude Code y Codex. Las flechas ofrecen varias formas, estilos y colores, además de un botón para copiar al portapapeles los valores incluidos en el letrero.

Funciones clave

  • 01Dibuja flechas, anillos y recuadros con letreros por encima de todas las ventanas y Spaces.
  • 02Los clics atraviesan la superposición y nunca se captura el foco del teclado.
  • 03Permite indicar objetivos mediante coordenadas, nombres de ventanas o aplicaciones, o etiquetas de elementos de Accessibility.
  • 04Las flechas desaparecen automáticamente al cumplirse un límite de tiempo, cuando termina el proceso propietario o mediante un comando para detenerlas.
  • 05Incluye un botón opcional para copiar los valores del letrero y conversión de texto a voz mediante --say.
  • 06Admite salida JSON y códigos de salida definidos para usar en scripts.

Casos de uso

  • Indicarle a un usuario qué botón debe presionar cuando un agente necesita que conceda un permiso.
  • Señalarle a una persona un paso de 2FA, CAPTCHA o pago que el agente no debería completar.
  • Guiar a alguien paso a paso por la interfaz de una aplicación o ayudar a un familiar mediante pantalla compartida.
  • Resaltar elementos de la interfaz al grabar demostraciones o generar capturas de pantalla anotadas.

Inicio rápido

  1. 1

    Instalar con Homebrew

    brew install franzenzenhofer/tap/bigarrow
  2. 2

    Enseñar la habilidad a Claude Code y Codex

    bigarrow install-skill
  3. 3

    Señalar un elemento de la interfaz con una flecha

    bigarrow point --element "Allow" --app "System Settings" --text "Franz, click Allow"

Antes de usarlo

  • Solo para macOS; para compilar desde el código fuente se requiere macOS 14 o posterior.
  • Para compilar desde el código fuente se necesita Xcode 16 o posterior.
  • Solo señala elementos; nunca hace clic, escribe ni captura la pantalla.

Temas

Preguntas frecuentes

¿Qué es big-arrow-on-the-screen?
CLI de macOS y skill para agentes de IA que dibuja flechas, recuadros y letreros grandes en pantalla para señalar elementos de la interfaz, sin hacer clic ni capturar nada. bigarrow es una herramienta de línea de comandos para macOS, escrita en Swift, que dibuja una flecha con un letrero por encima de todas las ventanas, en todas las pantallas y Spaces. Los clics atraviesan la superposición, el foco del teclado se mantiene donde estaba y la flecha se elimina al cumplirse un límite de tiempo, cuando termina el proceso del agente que la creó o cuando el usuario la detiene.
¿big-arrow-on-the-screen es gratuito? ¿Qué licencia tiene?
big-arrow-on-the-screen es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿big-arrow-on-the-screen sigue mantenido?
Mantenimiento activo. El último commit de big-arrow-on-the-screen fue el 18 oct 2026.
¿Para qué puedo usar big-arrow-on-the-screen?
Indicarle a un usuario qué botón debe presionar cuando un agente necesita que conceda un permiso. Señalarle a una persona un paso de 2FA, CAPTCHA o pago que el agente no debería completar. Guiar a alguien paso a paso por la interfaz de una aplicación o ayudar a un familiar mediante pantalla compartida. Resaltar elementos de la interfaz al grabar demostraciones o generar capturas de pantalla anotadas.
¿Cómo se instala big-arrow-on-the-screen?
Instalar con Homebrew: brew install franzenzenhofer/tap/bigarrow Enseñar la habilidad a Claude Code y Codex: bigarrow install-skill Señalar un elemento de la interfaz con una flecha: bigarrow point --element "Allow" --app "System Settings" --text "Franz, click Allow"
¿Dónde consigo big-arrow-on-the-screen?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/franzenzenhofer/big-arrow-on-the-screen

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

Proyectos relacionados