Skip to content
KitploitKITPLOIT
도구블로그
제출
도구블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

··피드·문의·개인정보·© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
finalrun-agent — 자연어를 사용하여 Android 및 iOS 앱을 테스트하는 AI 기반 CLI입니다. 에뮬레이터/시뮬레이터에서 엔드투엔드 테스트를 생성, 실행 및 수정하며, 합격/불합격 보고서와 비디오 로그를 제공합니다. | Kitploit
도구/GitHubGitHub/droid-ash/finalrun-agent
Android SecurityiOS SecurityMobile SecurityLearning & EducationAI Security
GitHubdroid-ash/finalrun-agent

finalrun-agent

자연어를 사용하여 Android 및 iOS 앱을 테스트하는 AI 기반 CLI입니다. 에뮬레이터/시뮬레이터에서 엔드투엔드 테스트를 생성, 실행 및 수정하며, 합격/불합격 보고서와 비디오 로그를 제공합니다.

저장소 보기
2993519일 전Kitploit 검토 완료

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →
공유
웹사이트

FinalRun 로고

GitHub release License: Apache-2.0

finalrun.app  •  Docs  •  Blog  •  Cloud Device Waitlist  •  Join Slack Community

팔로우하기

FinalRun on X   FinalRun on GitHub   FinalRun on LinkedIn

finalrun-agent는 자연어로 Android 및 iOS 앱을 테스트하는 AI 기반 CLI입니다. YAML에 평이한 영어 테스트를 작성하면, FinalRun이 에뮬레이터 또는 시뮬레이터에서 앱을 실행하고, AI 모델(Gemini, GPT, 또는 Claude)을 사용하여 화면을 인식하고 각 단계(탭, 스와이프, 타이핑)를 수행한 후, 비디오 및 장치 로그와 함께 합격/불합격 보고서를 생성합니다.

데모

FinalRun 데모

설치

macOS / Linux

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

Windows (PowerShell)

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

iOS 로컬 테스트는 macOS(xcodebuild)가 필요합니다. Windows에서는 iOS에 finalrun cloud를 사용하고, Android는 로컬에서 작동합니다. CI 플래그, 환경 변수 오버라이드 및 아티팩트 목록은 최신 릴리스 노트에 있습니다.

AI 에이전트를 사용하여 첫 번째 테스트 작성 및 실행

FinalRun은 AI 코딩 에이전트가 채팅에서 바로 테스트를 생성하고, 워크스페이스를 검증하며, 테스트를 실행할 수 있도록 하는 skills를 제공합니다.

테스트 생성

/finalrun-generate-test 스킬은 앱의 소스 코드를 읽고, 앱 ID를 추론한 후, 설정, 단계, 예상 상태를 포함한 완전한 테스트 스펙을 기능 폴더별로 생성합니다.

예시:

root@kitploit:~
/finalrun-generate-test 인증 기능에 대한 테스트 생성 — 유효한 자격 증명으로 로그인, 잘못된 비밀번호로 로그인, 로그아웃을 포함

에이전트는 다음을 수행합니다:

  1. 소스 코드를 읽어 UI를 이해하고 앱의 패키지 이름/번들 ID를 추론합니다.
  2. .finalrun/config.yaml 및 .finalrun/env/에 환경 바인딩을 설정합니다.
  3. 파일 경로 및 정리 전략이 포함된 테스트 계획을 제안하여 승인을 요청합니다.
  4. .finalrun/tests/auth/ 아래에 YAML 스펙을 생성하고 .finalrun/suites/ 아래에 스위트를 생성합니다.
  5. finalrun check를 실행하여 모든 것이 유효한지 확인합니다.

테스트 실행

/finalrun-use-cli 스킬은 테스트가 생성되면 이를 검증하고 실행합니다.

예시:

root@kitploit:~
/finalrun-use-cli Android에서 인증 테스트 실행

실패한 테스트 디버그 및 수정

/finalrun-test-and-fix 스킬은 전체 생성 → 실행 → 진단 → 수정 루프를 조정합니다. finalrun-generate-test를 통해 테스트를 작성하고, finalrun-use-cli를 통해 실행하며, 실패 시 CLI 아티팩트(result.json, actions/, 스크린샷, device.log)를 읽고, 버그가 앱 코드에 있는지 테스트에 있는지 분류한 후, 가장 좁은 범위의 수정을 적용하고 실행이 통과할 때까지 재실행합니다.

예시:

root@kitploit:~
/finalrun-test-and-fix Android에서 체크아웃 기능을 종단 간 확인 및 수정

기능 개발 완료 시 FinalRun이 자동으로 생성 및 테스트하도록 트리거하는 방법

이 **내용**을 AGENTS.md에 추가하면 FinalRun이 자동 트리거되므로, 에이전트에게 매번 명시적으로 테스트 생성 및 실행을 요청할 필요가 없습니다. 또한 개발 중 오류가 발생할 경우 에이전트가 문제를 수정할 수 있습니다.

API 키 (BYOK — 자체 키 사용)

FinalRun은 자체 AI 제공자 API 키를 사용하여 테스트를 실행합니다.

root@kitploit:~
echo "GOOGLE_API_KEY=your-key-here" > .env
제공자환경 변수
google/...GOOGLE_API_KEY
openai/...OPENAI_API_KEY
anthropic/...ANTHROPIC_API_KEY

테스트 실행은 설정된 제공자의 API 토큰을 소비합니다 — 표준 API 요금이 적용됩니다.

CLI로 수동 테스트 실행

root@kitploit:~
finalrun test smoke.yaml --platform android --model google/gemini-3-flash-preview
root@kitploit:~
finalrun suite auth_smoke.yaml --platform android --model google/gemini-3-flash-preview

문서

전체 문서: docs.finalrun.app

  • FinalRun 테스트 자동 트리거 (AI 에이전트) — 코딩 에이전트가 UI 작업 후 테스트를 생성, 검증 및 실행해야 하는 경우
  • YAML 테스트 — 테스트 형식, 필드, 스위트 및 환경 플레이스홀더
  • CLI 참조 — 모든 명령, 플래그 및 보고 도구
  • 설정 — 워크스페이스 설정, 앱 ID, --app 플래그 및 환경별 오버라이드
  • 환경 및 비밀 — dotenv 로드 순서, 제공자 키 및 플랫폼 사전 요구 사항
  • 문제 해결 — 일반적인 오류 및 해결 방법

개발

자세한 내용은 CONTRIBUTING.md에서 모노레포 구조, 빌드 명령 및 기여자 지침을 확인하세요.

  • CODE_OF_CONDUCT.md
  • SECURITY.md
  • CHANGELOG.md
  • LICENSE
도구 다운로드