Об этом проекте
opencode-pty — это плагин для OpenCode, обеспечивающий интерактивное управление псевдотерминалами (PTY). Он позволяет ИИ-агенту запускать фоновые процессы, отправлять интерактивный ввод и читать вывод по требованию, преодолевая ограничения встроенного синхронного bash-инструмента OpenCode.
Ключевые возможности включают:
- Фоновое выполнение длительных процессов (dev-серверы, режимы наблюдения, интерактивные программы)
- Несколько одновременных PTY-сессий
- Интерактивный ввод с escape-последовательностями (например, Ctrl+C)
- Буферизация вывода с пагинацией и фильтрацией по регулярным выражениям
- Уведомления о завершении для исключения опроса
- Уважение настроек разрешений bash в OpenCode
- Управление жизненным циклом сессий с автоматической очисткой
- Веб-интерфейс на React с потоковой передачей в реальном времени через WebSocket
- REST API для управления сессиями
Настройка проста: добавьте "opencode-pty" в конфигурацию OpenCode. Для V2 используйте "opencode-pty/v2" с дополнительными параметрами, такими как порт и имя хоста.
Плагин предоставляет инструменты: pty_spawn, pty_write, pty_read, pty_list, pty_kill, а также слэш-команды для открытия веб-интерфейса. Веб-интерфейс предлагает список сессий, живой вывод, отправку ввода и управление сессиями.
Конфигурация включает переменные окружения для размера буфера и настроек веб-сервера. Разрешения проверяются в соответствии с конфигурацией разрешений bash в OpenCode, с ограничениями для разрешений "ask".
В README приведены примеры использования, диаграммы жизненного цикла сессий и инструкции по разработке.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.