Repolode
Enviar
franzenzenhofer

franzenzenhofer/big-arrow-on-the-screen

CLI para macOS e skill de agente de IA que desenha setas, caixas e placas na tela para indicar elementos da interface, sem clicar nem capturar a tela.

Ver no GitHub
Estrelas
784
Forks
24
Issues abertas
4
Último commit
anteontem

O que é?

bigarrow é uma ferramenta de linha de comando em Swift para macOS que desenha uma seta com uma placa sobre todas as janelas, em todos os monitores e Spaces. Os cliques passam pelo overlay, o foco do teclado permanece onde estava e a seta se remove após um limite de tempo, quando o processo do agente que a criou é encerrado ou quando o usuário a interrompe.

O principal uso é permitir que agentes de IA indiquem algo na tela para uma pessoa, como um pedido de permissão, um botão a pressionar ou uma etapa de 2FA que o agente não pode executar. Os alvos podem ser definidos por coordenadas, nomes de janelas ou apps, ou rótulos de elementos da interface encontrados pela Accessibility API. A ferramenta nunca clica, digita nem captura a tela.

Ela é distribuída como um único binário, sem daemon, ícone na barra de menus ou conta, e pode ser instalada pelo Homebrew. Um instalador de skill adiciona instruções para Claude Code e Codex. As setas têm vários formatos, estilos e cores, além de um botão para copiar para a área de transferência valores exibidos na placa.

Recursos principais

  • 01Desenha setas, círculos e caixas com placas sobre todas as janelas e Spaces.
  • 02Os cliques passam pelo overlay e o foco do teclado nunca é capturado.
  • 03Define alvos por coordenadas, nome de janela ou app, ou rótulo de elemento da Accessibility API.
  • 04As setas desaparecem automaticamente após um limite de tempo, ao encerrar o processo proprietário ou com um comando de parada.
  • 05Oferece um botão opcional para copiar valores da placa e síntese de fala com --say.
  • 06Oferece saída JSON e códigos de saída definidos para uso em scripts.

Casos de uso

  • Indicar a um usuário em qual botão clicar quando um agente precisa que ele conceda uma permissão.
  • Apontar para uma etapa de 2FA, CAPTCHA ou pagamento que o agente não deve concluir.
  • Orientar alguém passo a passo pela interface de um app ou ajudar um familiar por compartilhamento de tela.
  • Destacar elementos da interface durante a gravação de demonstrações ou a geração de capturas de tela anotadas.

Início rápido

  1. 1

    Instalar pelo Homebrew

    brew install franzenzenhofer/tap/bigarrow
  2. 2

    Ensinar a habilidade ao Claude Code e ao Codex

    bigarrow install-skill
  3. 3

    Apontar uma seta para um elemento da interface

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

Antes de usar

  • Disponível apenas para macOS; é necessário o macOS 14 ou posterior para compilar a partir do código-fonte.
  • É necessário o Xcode 16 ou posterior para compilar a partir do código-fonte.
  • Apenas aponta para elementos; nunca clica, digita nem captura a tela.

Tópicos

#macos#ai-agents#claude-code#cli#accessibility#swift#screen-annotation#codex

Perguntas frequentes

O que é big-arrow-on-the-screen?
CLI para macOS e skill de agente de IA que desenha setas, caixas e placas na tela para indicar elementos da interface, sem clicar nem capturar a tela. bigarrow é uma ferramenta de linha de comando em Swift para macOS que desenha uma seta com uma placa sobre todas as janelas, em todos os monitores e Spaces. Os cliques passam pelo overlay, o foco do teclado permanece onde estava e a seta se remove após um limite de tempo, quando o processo do agente que a criou é encerrado ou quando o usuário a interrompe.
big-arrow-on-the-screen é gratuito? Qual é a licença?
big-arrow-on-the-screen é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
big-arrow-on-the-screen ainda é mantido?
Manutenção ativa. O último commit de big-arrow-on-the-screen foi em 18 de out. de 2026.
Para que posso usar big-arrow-on-the-screen?
Indicar a um usuário em qual botão clicar quando um agente precisa que ele conceda uma permissão. Apontar para uma etapa de 2FA, CAPTCHA ou pagamento que o agente não deve concluir. Orientar alguém passo a passo pela interface de um app ou ajudar um familiar por compartilhamento de tela. Destacar elementos da interface durante a gravação de demonstrações ou a geração de capturas de tela anotadas.
Como instalar big-arrow-on-the-screen?
Instalar pelo Homebrew: brew install franzenzenhofer/tap/bigarrow Ensinar a habilidade ao Claude Code e ao Codex: bigarrow install-skill Apontar uma seta para um elemento da interface: bigarrow point --element "Allow" --app "System Settings" --text "Franz, click Allow"
Onde consigo big-arrow-on-the-screen?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/franzenzenhofer/big-arrow-on-the-screen

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados