Xuepoo/waywarp-skill

Habilidade de agente de IA para Waywarp – automação programática de cursor e mouse em telas Wayland.

O que é waywarp-skill?

Esta habilidade permite que agentes de IA (como Claude Code, Cursor, Codex, etc.) controlem programaticamente o cursor e o mouse em sessões Wayland usando a ferramenta **Waywarp**. Ela é essencial para desenvolvedores que precisam automatizar interações gráficas (cliques, movimentos, arrastar e soltar) em ambientes Wayland, onde ferramentas tradicionais como xdotool não funcionam. A habilidade expõe comandos como `warp`, `click`, `rightclick`, `middleclick`, `scroll`, `type` e combinações de teclas, tudo via linha de comando. Suporta múltiplos monitores e registra logs com níveis configuráveis (DEBUG, INFO, WARN, ERROR). É projetada para ser usada em scripts ou diretamente pelo agente, facilitando tarefas repetitivas, testes de interface e automação de workflows no ecossistema Wayland.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add Xuepoo/waywarp-skill

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que waywarp-skill faz?

Habilidade de agente de IA para Waywarp – automação programática de cursor e mouse em telas Wayland

Fonte: https://github.com/Xuepoo/waywarp-skill

Enviado: 2026-06-02T05:29:59Z

Visão Geral

Waywarp-skill fornece um conjunto de comandos para controlar programaticamente o cursor do mouse e simular eventos de mouse/teclado em sessões Wayland usando a ferramenta Waywarp. Ideal para automação de interface gráfica, testes e manipulação remota de áreas de trabalho Wayland.

Comandos

  • warp <x> <y>: Move o cursor para coordenadas absolutas (em pixels) ou nomes de janela.
  • click: Realiza um clique com o botão esquerdo na posição atual.
  • rightclick: Realiza um clique com o botão direito.
  • middleclick: Realiza um clique com o botão do meio.
  • scroll <dx> <dy>: Rola o conteúdo (dx: horizontal, dy: vertical).
  • type <text>: Digita o texto fornecido (caracteres especiais escapados).
  • key <key_combo>: Envia uma combinação de teclas (ex: Ctrl+C, Alt+F4).

Uso

# Exemplo mover cursor para (100, 200)
waywarp warp 100 200

# Clicar com botão esquerdo
waywarp click

# Digitar texto
waywarp type "Olá Mundo"

# Enviar combinação de teclas
waywarp key Ctrl+Shift+Q

Configuração

Variáveis de ambiente:

  • WAYWARP_LOG_LEVEL: Nível de log (DEBUG, INFO, WARN, ERROR). Padrão: INFO.
  • WAYWARP_MONITOR: Índice do monitor (0-based). Padrão: 0.

Dependências

  • Python 3.8+
  • Biblioteca waywarp
  • Sessão Wayland ativa

Licença

MIT (consulte o arquivo LICENSE para detalhes).

Habilidades Relacionadas