Repolode
Предложить
onesuper

onesuper/tui-use

CLI для управления интерактивными терминальными программами — REPL, отладчиками и TUI-приложениями — через PTY с помощью AI-агентов.

Открыть на GitHub
Звёзды
270
Форки
25
Открытые issues
2
Последний коммит
6 месяцев назад

Что это?

tui-use — это CLI-инструмент, который позволяет AI-агентам работать с программами, рассчитанными на ввод с клавиатуры. Он запускает программу в псевдотерминале, отображает её вывод с помощью безголового эмулятора xterm и предоставляет текущее содержимое экрана в виде чистого обычного текста. Агент может отправлять нажатия клавиш, читать результат и решать, что делать дальше.

Инструмент предназначен для случаев, когда обычных shell-команд недостаточно: например, для сессии Python или pdb с большим объёмом данных в памяти, отладки в GDB, Node REPL или полноэкранных приложений вроде vim, lazygit, htop и fzf. Демон поддерживает PTY-сессии между отдельными вызовами CLI, поэтому процессу не приходится перезапускаться на каждом шаге.

Вместо пауз и периодических проверок команда `wait` завершается, когда экран остаётся неизменным в течение заданного периода бездействия или когда появляется указанный текстовый шаблон. В каждом снимке экрана также перечислены области, выделенные инверсным видео: по ним можно определить активный пункт меню или вкладку. Инструмент устанавливается через npm; в проект входят наборы плагинов для Claude Code и OpenAI Codex.

Ключевые возможности

  • 01Запускает любую программу в PTY и отображает её вывод с помощью безголового эмулятора xterm.
  • 02Предоставляет снимки экрана в виде обычного текста, при необходимости — в формате JSON.
  • 03Ожидает, пока экран перестанет меняться или пока не появится заданный текстовый шаблон.
  • 04Сообщает об областях с инверсным видео, чтобы агенты могли определить активный пункт.
  • 05Поддерживает сессии между вызовами CLI с помощью фонового демона.
  • 06Поддерживает ввод текста, вставку, нажатия специальных клавиш, прокрутку и поиск по экрану с помощью regex.

Сценарии использования

  • Отладка долгой сессии Python без потери данных, хранящихся в памяти.
  • Управление точками останова GDB или pdb и просмотр переменных с помощью агента.
  • Навигация AI-агента для написания кода по полноэкранным инструментам вроде vim или lazygit.
  • Работа с интерактивными REPL-сессиями, где каждый шаг зависит от результата предыдущего.

Быстрый старт

  1. 1

    Установите CLI из npm

    npm install -g tui-use
  2. 2

    Запустите программу в сеансе PTY

    tui-use start python3 examples/ask.py
  3. 3

    Дождитесь, пока экран стабилизируется, затем введите ответ и нажмите Enter

    tui-use wait
  4. 4

    Сделайте снимок текущего экрана

    tui-use snapshot

Что важно знать

  • Из вывода экрана удаляются цвета и большая часть форматирования текста; сохраняются только выделения, заголовок и состояние полноэкранного режима.
  • Перед использованием плагинов Claude Code или Codex необходимо отдельно установить CLI.

Темы

#terminal#cli#pty#ai-agents#repl#debugging#tui

Частые вопросы

Что такое tui-use?
CLI для управления интерактивными терминальными программами — REPL, отладчиками и TUI-приложениями — через PTY с помощью AI-агентов. tui-use — это CLI-инструмент, который позволяет AI-агентам работать с программами, рассчитанными на ввод с клавиатуры. Он запускает программу в псевдотерминале, отображает её вывод с помощью безголового эмулятора xterm и предоставляет текущее содержимое экрана в виде чистого обычного текста. Агент может отправлять нажатия клавиш, читать результат и решать, что делать дальше.
tui-use можно использовать бесплатно? Какая у него лицензия?
tui-use распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
tui-use всё ещё поддерживается?
Нет коммитов больше 6 месяцев. Последний коммит в tui-use — 11 апр. 2026 г..
Для чего можно использовать tui-use?
Отладка долгой сессии Python без потери данных, хранящихся в памяти. Управление точками останова GDB или pdb и просмотр переменных с помощью агента. Навигация AI-агента для написания кода по полноэкранным инструментам вроде vim или lazygit. Работа с интерактивными REPL-сессиями, где каждый шаг зависит от результата предыдущего.
Как установить tui-use?
Установите CLI из npm: npm install -g tui-use Запустите программу в сеансе PTY: tui-use start python3 examples/ask.py Дождитесь, пока экран стабилизируется, затем введите ответ и нажмите Enter: tui-use wait Сделайте снимок текущего экрана: tui-use snapshot
Где скачать tui-use?
Исходный код и инструкции по установке — на GitHub: https://github.com/onesuper/tui-use

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

herdrdev / herdr

Рабочее пространство в терминале на Rust для запуска coding agents в постоянных панелях: оно показывает, кто работает, заблокирован или простаивает, а агенты могут управлять им через CLI и socket API.

Инструменты разработчика#terminal-multiplexer#coding-agents#tui
44,8 тыс.3,6 тыс.RustApache-2.0Обновлён вчера