flutter-skill

flutter-skill

Dê olhos e mãos a qualquer agente de IA dentro de qualquer aplicativo em execução.
10 plataformas. Zero código de teste. Um servidor MCP.

Demonstração • Início Rápido • Plataformas de IA • Plataformas • vs Outros • Documentação

🚀 Zero configuração. Zero código de teste. Apenas converse com sua IA.

_{Se isso economizar seu tempo, considere dar uma estrela no repositório ⭐ — isso ajuda outras pessoas a encontrá-lo!}

Demonstração em 30 Segundos

https://github.com/user-attachments/assets/d4617c73-043f-424c-9a9a-1a61d4c2d3c6

Um único comando. 28 ações orientadas por IA. Zero código de teste. A IA explora um clone do TikTok, navega pelas abas, rola feeds, testa a busca, preenche formulários — tudo de forma autônoma.

Por Que Isso Existe

Escrever testes E2E é doloroso. Mantê-los é pior. flutter-skill adota uma abordagem diferente:

• 🔌 Conecta qualquer agente de IA (Claude, Cursor, Windsurf, Copilot, OpenClaw) diretamente ao seu aplicativo em execução via MCP
• 👀 O agente vê sua tela — toca em botões, digita texto, rola, navega — como um testador humano que nunca dorme
• ✅ Zero código de teste — sem Page Objects, sem XPath, sem seletores frágeis. Apenas inglês simples
• ⚡ Zero configuração — 2 linhas de código, funciona em todas as 10 plataformas

You: "Test the checkout flow with an empty cart, then add 3 items and complete purchase"

Your AI agent handles the rest — screenshots, taps, text entry, assertions, navigation.
No Page Objects. No XPath. No brittle selectors. Just plain English.

Início Rápido

1. Instale (30 segundos)

npm install -g flutter-skill

2. Adicione à sua IA (copie e cole na configuração do MCP)

{
  "mcpServers": {
    "flutter-skill": {
      "command": "flutter-skill",
      "args": ["server"]
    }
  }
}

Funciona com Claude Desktop, Cursor, Windsurf, Copilot, Cline, OpenClaw — qualquer agente compatível com MCP.

3. Adicione ao seu aplicativo (2 linhas para Flutter)

import 'package:flutter_skill/flutter_skill.dart';

void main() {
  if (kDebugMode) FlutterSkillBinding.ensureInitialized();
  runApp(MyApp());
}

4. Teste — basta conversar com sua IA:

"Inicie meu aplicativo, explore cada tela e relate quaisquer bugs"

É isso. Zero configuração. Zero código de teste. Funciona em menos de 60 segundos.

Uso com Plataformas de IA

Modo Servidor MCP (Integração com IDE)

Funciona com qualquer ferramenta de IA compatível com MCP. Uma linha de configuração:

{
  "mcpServers": {
    "flutter-skill": {
      "command": "flutter-skill",
      "args": ["server"]
    }
  }
}

Modo Servidor HTTP (CLI e Automação)

Para automação de navegador independente, pipelines de CI/CD ou acesso remoto:

# Start server
flutter-skill serve https://your-app.com

# Use CLI client commands
flutter-skill nav https://google.com
flutter-skill snap                    # Accessibility tree (99% fewer tokens)
flutter-skill screenshot /tmp/ss.jpg
flutter-skill tap "Login"
flutter-skill type "hello@example.com"
flutter-skill eval "document.title"
flutter-skill tools                   # List all available tools

Suporta flags --port=N, --host=H e variáveis de ambiente FS_PORT/FS_HOST.

Comparação dos Dois Modos

Referência completa do cliente CLI: docs/CLI_CLIENT.md

10 Plataformas, Uma Ferramenta

A maioria das ferramentas de teste funciona em 1-2 plataformas. O flutter-skill funciona em 10.

Total: 656/664 testes passando (98,8%) — cada plataforma testada com um aplicativo complexo de mídia social com mais de 50 elementos.

⚡ Desempenho

Benchmarks reais de execuções de testes automatizados contra um aplicativo complexo de mídia social:

Eficiência de tokens: snapshot() retorna uma árvore de elementos estruturada em vez de uma imagem — 87–99% menos tokens do que enviar screenshots para seu agente de IA.

Quão rápido é isso? Um tap leva 1–2 ms de ponta a ponta. Ferramentas de automação de navegador como Playwright e Selenium normalmente levam 50–100 ms para a mesma operação. Isso é 50–100× mais rápido, porque o flutter-skill fala diretamente com o runtime do aplicativo em vez de passar pela indireção do WebDriver ou CDP.

Sites com DOM Pesado (Mundo Real)

Testamos 15 ferramentas MCP em sites de produção — 75/75 passaram, zero timeouts:

O tempo total inclui o carregamento da página. A execução das ferramentas é consistentemente abaixo de 100ms mesmo em sites com DOM pesado.

Por Que Não Playwright / Appium / Detox?

| Compreensão de página por IA | ✅ Árvore AX | ❌ Screenshots | ❌ | ❌ | | Teste de limite/segurança | ✅ 13 payloads | ❌ | ❌ | ❌ | | Ações em lote | ✅ 5+/chamada | 1/chamada | 1/chamada | 1/chamada |

O flutter-skill é a única ferramenta de teste E2E nativa para IA que funciona em mobile, web e desktop — com 7× mais ferramentas que o concorrente mais próximo.

Comandos CLI

# 🤖 AI autonomous exploration — finds bugs automatically
flutter-skill explore https://my-app.com --depth=3

# 🐒 Monkey/fuzz testing — random actions, crash detection
flutter-skill monkey https://my-app.com --actions=100 --seed=42

# 🚀 Parallel multi-platform testing
flutter-skill test --url https://my-app.com --platforms web,electron,android

# 🌐 Zero-config WebMCP server — any website becomes testable
flutter-skill serve https://my-app.com

🧠 Nativo para IA: 95% Menos Tokens

A maioria das ferramentas de teste com IA envia screenshots para o LLM — cada uma custa ~4.000 tokens.

O flutter-skill usa a Árvore de Acessibilidade do Chrome para dar à sua IA um resumo semântico compacto de qualquer página:

// page_summary → ~200 tokens (vs ~4,000 for a screenshot)
{
  "title": "Shopping Cart",
  "nav": ["Home", "Products", "Cart", "Account"],
  "forms": [{"input:Coupon Code": "text"}],
  "buttons": ["Apply", "Checkout", "Continue Shopping"],
  "features": {"search": true, "pagination": true},
  "links": 47, "inputs": 3
}

Depois, execute várias ações em lote em uma única chamada:

// explore_actions → 5 actions per call (vs 5 separate tool calls)
{"actions": [
  {"type": "fill", "target": "input:Coupon Code", "value": "SAVE20"},
  {"type": "tap", "target": "button:Apply"},
  {"type": "tap", "target": "button:Checkout"},
  {"type": "fill", "target": "input:Email", "value": "test@example.com"},
  {"type": "tap", "target": "button:Continue"}
]}

Resultado: Seu agente de IA testa mais rápido, custa menos e entende as páginas melhor do que ferramentas baseadas em screenshots.

O Que Ele Pode Fazer

Configuração da Plataforma

dependencies:
  flutter_skill: ^0.9.37

import 'package:flutter_skill/flutter_skill.dart';

void main() {
  if (kDebugMode) FlutterSkillBinding.ensureInitialized();
  runApp(MyApp());
}

npm install flutter-skill-react-native

import FlutterSkill from 'flutter-skill-react-native';
FlutterSkill.start();

npm install flutter-skill-electron

const { FlutterSkillBridge } = require('flutter-skill-electron');
FlutterSkillBridge.start(mainWindow);

// Swift Package Manager: FlutterSkillSDK
import FlutterSkill
FlutterSkillBridge.shared.start()

Text("Hello").flutterSkillId("greeting")

implementation("com.flutterskill:flutter-skill:0.8.0")

FlutterSkillBridge.start(this)

[dependencies]
flutter-skill-tauri = "0.8.0"

Exemplos de Prompts

Basta dizer à sua IA o que testar:

Contribuindo

Veja CONTRIBUTING.md para diretrizes.

git clone https://github.com/ai-dashboad/flutter-skill
cd flutter-skill
dart pub get
dart run bin/flutter_skill.dart server  # Start MCP server

Links

⭐ Se o flutter-skill economizar seu tempo, dê uma estrela para que outros também possam encontrá-lo!

Licença MIT © 2025