KushoAI UI Testing TUI

KushoAI UI Testing TUI란?

KushoAI UI Testing TUI는 기록된 브라우저 흐름에서 Playwright UI 테스트 스위트를 생성하는 오픈소스 명령줄 인터페이스(TUI)입니다. 모든 클릭과 입력을 수동으로 번역하는 대신, 사용자 작업을 한 번 기록한 후 AI를 사용해 해당 기록을 추가 테스트 변형으로 확장합니다. 엣지 케이스와 에러 시나리오를 포함합니다.

코어 워크플로는 터미널 내에서 유지됩니다: Playwright 브라우저 레코더로 기록, 터미널 에디터에서 생성된 Playwright 스크립트 검토 및 조정, 그리고 일반 영어 지시로 KushoAI에 스위트 확장 요청. 결과 테스트를 헤드리스 또는 가시 브라우저로 실행하고 상세 HTML 보고서를 생성할 수 있습니다.

주요 기능

• Playwright 브라우저 레코더로 UI 흐름 기록: 네비게이션, 클릭, 폼 입력, 제출을 실제 브라우저에서 캡처해 테스트 생성의 출발점으로 사용.
• AI가 단일 기록을 포괄적 Playwright 스위트로 확장: 원시 캡처 흐름에서 다중 변형, 엣지 케이스, 에러 시나리오 생성.
• 대화형 TUI 메뉴(화살표 키 안내 워크플로): 자격 증명, 기록, 테스트 생성, 실행을 위한 프롬프트 단계 제공. 플래그 암기 불필요.
• 일반 영어 지시로 생성 테스트 편집 및 세밀 조정: “Kusho Edit” 흐름으로 확장 테스트를 반복 조정해 원하는 커버리지 적용.
• 헤드리스 또는 헤디드 모드로 테스트 실행, 비디오 및 HTML 보고서 옵션: 실행 모드 선택하고 실패 검사에 유용한 아티팩트 생성.
• 로컬 실행 및 자격 증명 저장: 자격 증명은 ~/.kusho-credentials에 저장되며, 선택한 LLM 제공자 사용.

KushoAI UI Testing TUI 사용법

1. CLI 설치 및 링크: 저장소 클론, 종속성 설치, Playwright 브라우저 바이너리 설치, kusho 명령 글로벌 링크.
   • 페이지 예시 명령:
     • git clone https://github.com/kusho-co/kusho-ui-testing-tui.git
     • cd kusho-ui-testing-tui
     • npm install
     • npx playwright install
     • npm link
     • 확인: kusho --help
2. LLM 제공자 자격 증명 설정: kusho credentials 실행, 제공자(OpenAI, Anthropic, Google Gemini) 선택 후 API 키 입력. ~/.kusho-credentials에 로컬 저장.
3. 사용자 흐름 기록: 대상 URL로 kusho record 실행(또는 URL 생략하고 대화형 입력). 브라우저 작업 완료 후 닫기; 생성된 Playwright 스크립트가 터미널 에디터에서 열림.
   • 스크립트는 kusho-tests/recordings/에 저장.
4. 테스트 스위트 생성: kusho extend(또는 TUI “Extend” / “Kusho Edit”)로 기록을 선택 LLM에 전송해 추가 변형 포함 확장 스위트 생성.
5. 스위트 실행: 확장 테스트를 헤드리스 또는 헤디드 모드, 비디오 녹화 및 상세 HTML 보고서 옵션으로 실행.

안내 경험을 원하면 kusho ui로 대화형 메뉴 시작하고 화살표 키로 자격 증명 설정, 기록, 테스트 생성, 실행 완료.

사용 사례

• 해피 패스 이상 커버: 주요 사용자 흐름만 테스트하는 팀이 한 번 기록으로 엣지 케이스와 에러 상태 포함 추가 시나리오 생성.
• 경계 조건 QA 워크플로: QA 엔지니어가 실제 상호작용(폼 입력, 네비게이션, 제출)으로 시작해 경계 조건과 네거티브 케이스 확장.
• 원본 캡처 흐름 디버깅: “Run recording” 옵션으로 원시 기록 기반 테스트 실행해 AI 확장 전에 캡처 내용 확인.
• 반복적 커버리지 세밀화: 개발자가 초기 스위트 확장 후 “Kusho Edit”으로 일반 영어 지시 기반 커버리지 조정.
• 팀 간 UI 테스트 생성 표준화: 터미널 중심 루프(record → review → extend → run)로 웹 앱 간 Playwright 테스트 반복 워크플로 제공.

자주 묻는 질문

KushoAI UI Testing TUI가 생성하는 것은? 캡처된 UI 흐름 기반 Playwright 테스트 스위트 생성. 추가 변형, 엣지 케이스, 에러 시나리오 포함.

Playwright 코드를 처음부터 작성해야 하나요? 아니요. Playwright 브라우저 레코더로 흐름 기록 후 터미널 에디터에서 생성 스크립트 검토 및 편집.

지원 LLM 제공자는? 페이지에 OpenAI, Anthropic, Google Gemini 나열. 설정 중 기본 모델 오버라이드 가능.

API 키는 어디 저장되나요? 도구가 ~/.kusho-credentials에 로컬 저장하고 선택 제공자 호출 시 사용.

브라우저 창에서 테스트 실행 가능하나요? 네. 페이지에 헤드리스 또는 가시 브라우저(“headed mode”)로 테스트 스위트 실행 가능. 비디오 녹화 옵션 언급.

대안

• 수동 Playwright 테스트 작성: Playwright에서 직접 테스트를 작성하면 완전한 제어를 제공하지만, 각 클릭/입력 번역과 엣지 케이스 테스트를 수동으로 추가해야 합니다.
• 스크립트 상호작용을 통한 컴포넌트/UI 테스트 프레임워크: 스크립트나 개발자 작성 시나리오에서 테스트를 생성하는 프레임워크는 여전히 해당 시나리오를 작성해야 하며, 대화형 브라우저 기록에서 시작하지 않습니다.
• 기록 및 재생 중심 자동화 도구 (Playwright 우선 아님): 기록 및 재생 방식은 사용자 작업을 빠르게 캡처할 수 있지만, Playwright 테스트 스위트 생성에 맞춤화되지 않아 추가 변환 단계가 필요할 수 있습니다.
• 테스트를 위한 AI 지원 코드 생성: 일반 AI 코딩 도구는 테스트 작성이나 확장을 도울 수 있지만, 단일 UI 흐름의 Playwright 기록 및 확장을 중심으로 한 터미널 우선 루프를 제공하지 않습니다.