finalrun-agent

finalrun.app  •  Docs  •  Blog  •  Lista de Espera de Dispositivo na Nuvem  •  Entre na Comunidade Slack

Siga-nos em

finalrun-agent é uma CLI baseada em IA que testa seus aplicativos Android e iOS usando linguagem natural. Você escreve um teste em inglês simples no YAML, o FinalRun inicia seu aplicativo em um emulador ou simulador, usa um modelo de IA (Gemini, GPT ou Claude) para ver a tela e executar cada etapa — tocar, deslizar, digitar — e produz um relatório de aprovação/reprovação com vídeo e logs do dispositivo.

Demonstração

Instalação

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/final-run/finalrun-agent/main/scripts/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/final-run/finalrun-agent/main/scripts/install.ps1 | iex

O teste local no iOS requer macOS (xcodebuild). No Windows, use finalrun cloud para iOS — o Android funciona localmente. As flags de CI, substituições de env e a lista de artefatos estão nas notas da versão mais recente.

Escreva e Execute Seu Primeiro Teste Usando Agentes de IA

O FinalRun oferece skills que permitem que seu agente de codificação de IA gere testes, valide workspaces e execute testes — tudo pelo chat.

Gerar testes

A skill /finalrun-generate-test lê o código-fonte do seu aplicativo, infere a identidade do aplicativo e gera especificações de teste completas com configuração, etapas e estado esperado — organizadas por pasta de funcionalidade.

Exemplo:

/finalrun-generate-test Generate tests for the authentication feature — cover login with valid credentials, login with wrong password, and logout

O agente irá:

1. Ler seu código-fonte para entender a interface do usuário e inferir o nome do pacote / ID do bundle do aplicativo
2. Configurar .finalrun/config.yaml e vinculações de ambiente em .finalrun/env/
3. Propor um plano de teste com caminhos de arquivo e estratégia de limpeza para sua aprovação
4. Gerar especificações YAML em .finalrun/tests/auth/ e uma suíte em .finalrun/suites/
5. Executar finalrun check para validar tudo

Executar testes

A skill /finalrun-generate-test valida e executa o teste depois que seus testes são gerados.

Exemplo:

/finalrun-use-cli Run the auth tests on Android

Depurar e corrigir testes com falha

A skill /finalrun-test-and-fix orquestra o ciclo completo gerar → executar → diagnosticar → corrigir. Ela cria testes via finalrun-generate-test, executa-os via finalrun-use-cli, lê os artefatos da CLI (result.json, actions/, capturas de tela, device.log) em caso de falha, classifica se o bug está no código do aplicativo ou no teste, aplica a correção mais restrita e reexecuta até que a execução fique verde.

Exemplo:

/finalrun-test-and-fix Verify and fix the checkout feature end-to-end on Android

Como acionar automaticamente o FinalRun para gerar e testar quando o desenvolvimento da funcionalidade for concluído

Adicione este conteúdo ao seu AGENTS.md para acionar automaticamente o FinalRun, para que você não precise pedir explicitamente ao seu agente para gerar e executar testes toda vez. Isso também permitirá que seu agente corrija problemas se houver algum erro durante o desenvolvimento.

Chaves de API (BYOK — Traga Sua Própria Chave)

O FinalRun usa sua própria chave de API do provedor de IA para executar testes.

echo "GOOGLE_API_KEY=your-key-here" > .env

As execuções de teste consomem tokens de API do seu provedor configurado — a cobrança padrão da API se aplica.

Executando Testes manualmente com a CLI

finalrun test smoke.yaml --platform android --model google/gemini-3-flash-preview

finalrun suite auth_smoke.yaml --platform android --model google/gemini-3-flash-preview

Documentação

Documentação completa: docs.finalrun.app

• Acionamento automático de testes do FinalRun (agentes de IA) — quando os agentes de codificação devem gerar, validar e executar testes após o trabalho na interface do usuário
• Testes YAML — formato do teste, campos, suítes e placeholders de ambiente
• Referência da CLI — todos os comandos, flags e ferramentas de relatório
• Configuração — configuração do workspace, identidade do aplicativo, flag --app e substituições por ambiente
• Ambiente e Segredos — ordem de carregamento do dotenv, chaves de provedor e pré-requisitos de plataforma
• Solução de problemas — erros comuns e correções

Desenvolvimento

Consulte CONTRIBUTING.md para estrutura do monorepo, comandos de build e diretrizes para contribuidores.

• CODE_OF_CONDUCT.md
• SECURITY.md
• CHANGELOG.md
• LICENSE