droid-ash/finalrun-agentKI-gesteuerte CLI zum Testen von Android- und iOS-Apps mittels natürlicher Sprache. Erstellt, führt und repariert End-to-End-Tests auf Emulatoren/Simulatoren mit Bestehen/Nichtbestehen-Berichten und Videoprotokollen.
finalrun.app • Dokumentation • Blog • Warteliste für Cloud-Geräte • Slack-Community beitreten
finalrun-agent ist ein KI-gestütztes CLI, das Ihre Android- und iOS-Apps mit natürlicher Sprache testet. Sie schreiben einen Test in einfachem Englisch in YAML, FinalRun startet Ihre App auf einem Emulator oder Simulator, verwendet ein KI-Modell (Gemini, GPT oder Claude), um den Bildschirm zu sehen und jeden Schritt auszuführen — Antippen, Wischen, Tippen — und erstellt einen Bestanden/Nicht bestanden-Bericht mit Video- und Geräteprotokollen.
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
iOS-Lokaltests erfordern macOS (xcodebuild). Unter Windows verwenden Sie finalrun cloud für iOS — Android funktioniert lokal. CI-Flags, Umgebungsüberschreibungen und die Liste der Artefakte finden Sie in den Release Notes der neuesten Version.
FinalRun liefert Skills aus, mit denen Ihr KI-Coding-Agent Tests generieren, Arbeitsbereiche validieren und Tests ausführen kann — alles aus dem Chat.
Der /finalrun-generate-test Skill liest den Quellcode Ihrer App, leitet die App-Identität ab und generiert vollständige Testspezifikationen mit Einrichtung, Schritten und erwartetem Zustand — organisiert nach Feature-Ordnern.
Beispiel:
/finalrun-generate-test Generate tests for the authentication feature — cover login with valid credentials, login with wrong password, and logout
Der Agent wird:
.finalrun/config.yaml und Umgebungsbindungen in .finalrun/env/ einrichten..finalrun/tests/auth/ und eine Suite unter .finalrun/suites/ generieren.finalrun check ausführen, um alles zu validieren.Der /finalrun-generate-test Skill validiert und führt den Test aus, sobald Ihre Tests generiert sind.
Beispiel:
/finalrun-use-cli Run the auth tests on Android
Der /finalrun-test-and-fix Skill orchestriert den gesamten Generieren → Ausführen → Diagnostizieren → Reparieren-Zyklus. Er erstellt Tests über finalrun-generate-test, führt sie über finalrun-use-cli aus, liest bei Fehlschlag die CLI-Artefakte (result.json, actions/, Screenshots, device.log), klassifiziert, ob der Bug im App-Code oder im Test liegt, wendet die engste Korrektur an und wiederholt den Vorgang, bis der Lauf grün ist.
Beispiel:
/finalrun-test-and-fix Verify and fix the checkout feature end-to-end on Android
Fügen Sie diesen Inhalt zu Ihrer AGENTS.md hinzu, um Finalrun automatisch auszulösen, damit Sie Ihren Agenten nicht jedes Mal explizit bitten müssen, Tests zu generieren und auszuführen. So kann Ihr Agent auch Probleme beheben, falls während der Entwicklung Fehler auftreten.
FinalRun verwendet Ihren eigenen KI-Anbieter-API-Schlüssel zum Ausführen von Tests.
echo "GOOGLE_API_KEY=your-key-here" > .env
| Anbieter | Umgebungsvariable |
|---|---|
google/... | GOOGLE_API_KEY |
openai/... | OPENAI_API_KEY |
anthropic/... | ANTHROPIC_API_KEY |
Testläufe verbrauchen API-Token von Ihrem konfigurierten Anbieter – die übliche API-Abrechnung gilt.
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
Vollständige Dokumentation: docs.finalrun.app
--app-Flag und anwendungsspezifische ÜberschreibungenSiehe CONTRIBUTING.md für Monorepo-Struktur, Build-Befehle und Richtlinien für Mitwirkende.