agent-tui CLI
Управляет TUI-программами из агента: запускает их в PTY-сессии, снимает экран, жмет клавиши и ждет нужного текста.
- 121 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агент вводит текст и клавиши в запущенные программы с вашими правами.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/agent-tuiОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент вводит текст и клавиши в запущенные программы с вашими правами.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
agent-tui — CLI, который запускает терминальные программы в изолированных PTY-сессиях и отдает агенту их экран. Команды `run`, `screenshot`, `press`, `type`, `scroll` и `wait` образуют цикл: агент смотрит на экран, действует и дожидается результата. Вывод бывает текстовым или JSON. В репозитории лежит скилл `skills/agent-tui/SKILL.md`. Он учит агента снимать экран после каждого действия, проверять итог через `wait --assert` и закрывать сессию командой `kill --yes`. Фоновый демон ведет несколько сессий сразу, а живой просмотр работает по WebSocket.
Для кого. Разработчикам и тестировщикам, которые поручают агенту проверку интерактивных консольных программ вроде htop или vim.
Подходит, если
- Агент проходит интерактивный мастер в терминале и сверяет каждый экран.
- Регрессионный сценарий для TUI-приложения строят из нажатий и ожиданий текста.
- Текст с экрана консольной программы нужен агенту в JSON.
- Демонстрацию терминального инструмента воспроизводят одним и тем же сценарием.
Не подходит, если
- Автоматизируют браузер или графическое приложение.
- Система работает на нативном Windows, где агент не запустится.
- Команда не интерактивна, и хватает обычного запуска в шелле.
Пример запроса к агенту
Запусти htop через agent-tui, сделай снимок экрана, найди процесс с самой высокой нагрузкой на CPU и закрой сессию.Ограничения
Только Unix: Linux, macOS и системы с PTY и доменными сокетами. Нативный Windows и PowerShell не поддерживаются. Старые команды `input`, `action` и `scroll-into-view` объявлены устаревшими и уйдут в следующем мажорном выпуске. Агент вводит текст и клавиши в любую запущенную программу, поэтому запускайте в сессии только то, что безопасно им управлять. Состояние сессий лежит в `~/.agent-tui/`. Демон по умолчанию слушает только `127.0.0.1`, нелокальный доступ включает переменная `AGENT_TUI_WS_ALLOW_REMOTE`.
Как отключить. Остановите демон командой `agent-tui daemon stop --yes`, уберите скилл из каталога скиллов агента и удалите пакет тем менеджером, которым ставили. Папку `~/.agent-tui/` очистите вручную.
Частые вопросы
Как выглядит рабочий цикл?
Сессию открывает `agent-tui run`, экран снимает `agent-tui screenshot`, действие задают `press`, `type` или `scroll`, результат ждет `wait`. В конце сессию закрывает `agent-tui kill --yes`.
Как получить вывод в JSON?
Передайте `--format json` в `run` и `screenshot`; README показывает также `agent-tui screenshot --json`. В ответе есть `session_id` и снимок экрана.
Работает ли на Windows?
Нет. Нативный Windows не поддерживается, нужен Linux, macOS или другая Unix-система с PTY.
Как следить за сессией вживую?
Выполните `agent-tui live start --open`. Просмотр идет через JSON-RPC поверх WebSocket.
Где хранится состояние?
По умолчанию в `~/.agent-tui/`: `api.json`, `sessions.jsonl` и состояние интерфейса. Пути меняют `AGENT_TUI_WS_STATE` и `AGENT_TUI_SESSION_STORE`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI Microsoft управляет настоящими терминальными сессиями, проверяет видимый текст и записывает ход теста для разбора ошибок.
Локальный отладчик TypeScript-агентов: дерево шагов, проверка траектории в CI и архив доказательств без аккаунта.
Самообучающийся QA-агент: тесты для веба и мобильных на естественном языке, которые сами чинятся и запоминают прогоны
Скилл и агент-тестировщик для Claude Code: проверяют интерфейс 1С через MCP-сервер 1c-testpilot с доказательствами
Около 70 скиллов для автотестов: Selenium, Playwright, Cypress, Appium, JUnit, pytest и другие, с запуском на облаке TestMu AI
Система сценарного тестирования 1С:Предприятия с набором agent skills, которые позволяют ИИ-агенту управлять приложением как обычный пользователь
Коротко о README
Демон держит PTY-сессии, а CLI общается с ним через сокет Unix. Ожидание строится на тексте экрана или его стабильности.