O que peekaboo faz?
Habilidade de agente: automação de interface do macOS via Peekaboo CLI.
Visão Geral
Esta habilidade capacita agentes de IA a interagir com a interface do usuário do macOS de forma programática, utilizando a ferramenta de linha de comando peekaboo. Com ela, você pode automatizar tarefas como clicar em botões, digitar texto, capturar screenshots e extrair informações de elementos da tela.
Pré-requisitos
- macOS 11.0 ou superior
- Peekaboo CLI instalado e no PATH
- Permissões de acessibilidade concedidas ao terminal/agente
Como usar
Comandos suportados
| Comando | Descrição |
|---|---|
peekaboo tap <x> <y> | Clica em uma coordenada específica |
peekaboo type "<texto>" | Digita o texto especificado |
peekaboo screenshot <path> | Captura uma screenshot da tela atual |
peekaboo get-text <x> <y> | Obtém o texto de um elemento em determinada posição |
Exemplo de uso
# Clicar no botão "OK"
peekaboo tap 500 300
# Digitar texto em um campo
peekaboo type "Olá, mundo!"
# Capturar screenshot
peekaboo screenshot /tmp/screenshot.png
Tratamento de erros
Caso o Peekaboo não esteja instalado ou as permissões não estejam configuradas, a habilidade retornará uma mensagem de erro clara com instruções de correção.
Segurança
- A habilidade nunca executa comandos arbitrários não relacionados ao Peekaboo.
- Todos os caminhos de arquivo são validados antes da execução.
Compatibilidade
- Agentes compatíveis: Claude Code, Cursor, Codex e outros que suportem execução de comandos no terminal.
- Sistema operacional: macOS apenas.
Contribuição
Pull requests são bem-vindos! Consulte o repositório original para mais detalhes.