Sobre o projeto
opencode-pty é um plugin para OpenCode que fornece gerenciamento interativo de pseudo-terminal (PTY). Ele permite que o agente de IA execute processos em segundo plano, envie entrada interativa e leia a saída sob demanda, superando as limitações da ferramenta bash síncrona integrada do OpenCode.
Os principais recursos incluem:
- Execução em segundo plano de processos de longa duração (servidores de desenvolvimento, modos watch, programas interativos)
- Múltiplas sessões PTY simultâneas
- Entrada interativa com sequências de escape (por exemplo, Ctrl+C)
- Buffer de saída com paginação e filtragem regex
- Notificações de saída para eliminar polling
- Respeita as configurações de permissão bash do OpenCode
- Gerenciamento do ciclo de vida da sessão com limpeza automática
- Uma interface web baseada em React com streaming em tempo real via WebSocket
- API REST para gerenciamento de sessões
A configuração é simples: adicione "opencode-pty" à sua configuração do OpenCode. Para V2, use "opencode-pty/v2" com opções opcionais como porta e hostname.
O plugin fornece ferramentas: pty_spawn, pty_write, pty_read, pty_list, pty_kill e comandos de barra para abrir a interface web. A interface web oferece lista de sessões, saída ao vivo, envio de entrada e gerenciamento de sessões.
A configuração inclui variáveis de ambiente para tamanho do buffer e configurações do servidor web. As permissões são verificadas em relação à configuração de permissão bash do OpenCode, com limitações em permissões "ask".
O README inclui exemplos de uso, diagramas do ciclo de vida da sessão e instruções de desenvolvimento.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.