microsoft/tui-test
💻 control, record, & test any tui app / cli with popular terminals - makes the terminal fully accessible to AI
해결하는 문제
tui-test는 Windows, Linux, macOS에서 터미널 애플리케이션과 셸 세션을 안정적으로 자동화하고 테스트하는 문제를 해결합니다. 실행 중인 터미널의 상태(표시 텍스트, 스타일, 커서 위치, 스크롤백, 클립보드 등)에 대한 구조화된 액세스를 제공하고 입력, 클릭, 스크롤, 크기 조정과 같은 실제 사용자 작업을 수행할 수 있습니다. 이는 전체 화면 TUI 앱 검증, 반복적인 터미널 워크플로 스크립팅, AI 에이전트가 명령줄 환경과 상호 작용할 수 있는 제어된 방법을 제공하는 데 특히 유용합니다.
작동 방식
tui-test는 터미널 세션을 시뮬레이션하지 않고 실제 터미널 세션을 제어합니다. 터미널 백엔드(Alacritty, Ghostty, Rio, xterm.js 등) 내에서 셸이나 프로그램을 실행한 다음 CLI와 Rust, Python, JavaScript, Go용 네이티브 라이브러리를 통해 균일한 작업 집합을 노출합니다. 화면에서 텍스트 찾기(정규식, 앵커, 스타일 일치 사용), 키보드 및 마우스 입력 수행, 터미널 상태 읽기(종료 코드, 커서, 뷰포트, 벨 이벤트), 조건 대기(텍스트, 유휴, 종료, 준비), 출력을 스크린샷, GIF/MP4/APNG 녹화 또는 asciinema 캐스트로 캡처하는 명령을 실행할 수 있습니다. 세션은 CLI 명령 간에 유지되며 동일한 기본 엔진이 지원되는 모든 언어에서 작동합니다. AI 에이전트의 경우 이 도구는 구조화된 출력(JSON, 추적 파일)과 에이전트 워크플로에 통합하기 위한 스킬 명령을 제공합니다.
대상 사용자
이 도구는 터미널 UI, 특히 크로스 플랫폼 도구와 전체 화면 앱을 자동화하고 테스트해야 하는 개발자와 QA 엔지니어를 위해 제작되었습니다. 또한 터미널 상태에 대한 구조화된 액세스와 제어된 입력이 필요한 AI 에이전트, 셸 또는 CLI 프로그램용 자동화 스크립트를 작성하는 모든 사람에게 적합합니다.
주요 기능
- 크로스 플랫폼 지원: Windows, Linux, macOS, 여러 셸(bash, zsh, fish, PowerShell, cmd 등)
- 여러 인터페이스: CLI 및 Rust, Python, JavaScript, Go용 네이티브 라이브러리
- 풍부한 텍스트 로케이터: 정규식, 앵커(앞/뒤), 스타일 일치, 링크 확인, 구성 가능한 로케이터(AND/OR)
- 완전한 입력 시뮬레이션: 키보드, 마우스 클릭/드래그/스크롤, 크기 조정, 신호, 원시 데이터 쓰기
- 상태 검사: 커서, 뷰포트, 클립보드, 제목, 벨, 종료 코드, 명령 출력 등
- 구성 가능한 시간 제한이 있는 대기 및 어서트 명령(텍스트, 유휴, 종료, 준비)
- 캡처 및 녹화: SVG/PNG 스크린샷, APNG/GIF/MP4 녹화, asciinema 캐스트
- 실패한 어서션에 대한 구조화된 진단(trace.md, trace.json, timeline.json)을 제공하는 추적 뷰어
- AI 에이전트 친화적:
usage,agent-context,skill명령이 전체 명령 스키마와 에이전트 가이드를 노출 tui-test.toml을 통해 프로필, 색상, 녹화 스타일, 추적 설정 구성 가능
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트