tui-test CLI
CLI Microsoft управляет настоящими терминальными сессиями, проверяет видимый текст и записывает ход теста для разбора ошибок.
- 308 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- CLI запускает выбранные программы и отправляет ввод в реальные сессии с правами своего пользователя.
Установка
Ручная установка
brew tap microsoft/tui-test https://github.com/microsoft/tui-test
brew install tui-testПервый блок установки CLI из README, оба шага Homebrew.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI запускает выбранные программы и отправляет ввод в реальные сессии с правами своего пользователя.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
tui-test дает агенту структурированный доступ к терминальному приложению. Через CLI можно запустить программу, найти надпись, нажать клавишу и дождаться ожидаемого состояния. Экран доступен как текст и ячейки со стилями, поэтому агент может проверять результат по наблюдаемым данным. Сессия сохраняется между отдельными командами. Для воспроизводимого теста есть проверки текста, кода завершения и снимков состояния; при ошибке можно сохранить материалы, которые человек откроет в просмотрщике трассировки.
Для кого. QA-инженерам терминальных приложений, которым нужно воспроизводить действия пользователя и сохранять доказательства сбоя.
Подходит, если
- После изменения TUI нужно пройти сценарий клавишами и проверить итоговую надпись.
- Плавающая ошибка требует записи терминальной сессии для последующего разбора.
- В CI надо сравнить экран приложения с сохраненным снимком.
- Агенту нужно прочитать вывод долгой команды и отличить завершение от временной паузы.
Не подходит, если
- Тестируемый интерфейс работает в браузере и требует доступа к DOM.
- Окружение не разрешает запускать проверяемую программу как дочерний процесс.
- Необходимо автоматически доказать корректность программы по одному отсутствию обновлений экрана.
Пример запроса к агенту
Запусти мой терминальный мастер, выбери тестовый проект и проверь появление сообщения об успехе. При ошибке сохрани трассировку.Ограничения
CLI работает с настоящим процессом, поэтому тестируемой программе нужны ее обычные зависимости и разрешения. Для записи MP4 требуется ffmpeg; до теста с видео проверьте его доступность в окружении CLI. Сессии живут между командами, и повторный запуск может использовать уже открытый терминал, пока вы не запросите перезапуск. Даже если экран перестал обновляться, программа может продолжать работу: проверяйте окончание команды и ее код возврата отдельно.
Как отключить. Закройте нужную сессию командой `tui-test close` и остановите фоновый процесс, если он больше не нужен. Перед удалением сохраните материалы неудачных тестов.
Частые вопросы
Как агент узнает доступные команды?
Выполните `tui-test agent-context` для JSON-схемы или `tui-test usage` для короткой справки. Выбирайте действия по этой схеме.
Можно ли искать надпись в истории?
Да. Флаг `--full` включает прокрутку в поиск. Перед мышиным действием вернитесь к текущему экрану.
Как сохранить изображение экрана?
Используйте `tui-test screenshot -o result.svg`. Для проверки оформления можно выбрать PNG и настроить стиль снимка.
Что читать агенту после сбоя?
Сначала `trace.md`, затем структурированные `trace.json` и `timeline.json`. Человеку предназначен просмотрщик `trace.html`.
Нужен ли CLI для Python-тестов?
Нет. Библиотека Python использует тот же движок внутри процесса. Выберите библиотеку, если тесты уже написаны на Python.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыУправляет TUI-программами из агента: запускает их в PTY-сессии, снимает экран, жмет клавиши и ждет нужного текста.
Qlty CLI показывает дубли и сложные участки кода до рефакторинга; автоматическое форматирование запускается отдельно.
MCP-инструмент для интерактивного управления интерфейсом 1С:Предприятия через тестовый клиент: клики, поля, таблицы и доказательная запись сценария
MCP-сервер, агент и скиллы для сквозных UI-тестов: агент управляет компьютером через компьютерное зрение на облачных машинах
Система сценарного тестирования 1С:Предприятия с набором agent skills, которые позволяют ИИ-агенту управлять приложением как обычный пользователь
CLI создает Python-окружения и повторяет сборку, установку и тесты проекта, чтобы агент проверял совместимость конфигураций.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| tui-test (эта карточка) | нет | 308 | ||
| Tmux MCP Server — доступ агента к сессиям tmux | нет | не нужна | 306 | tui-test добавляет проверки экранного состояния и запись тестов; Tmux MCP Server управляет окнами, панелями и командами существующего tmux. |
| hyperfine | нет | 29 215 | hyperfine многократно запускает команды, сравнивает время и другие показатели и сохраняет результаты измерений в файлы. |
Коротко о README
Доступны привязки для Rust, Python, JavaScript и Go. Настройки внешнего вида, записи и диагностических материалов хранятся в TOML-профилях.