Repolode
Enviar
onesuper

onesuper/tui-use

Uma CLI que permite a agentes de IA controlar programas interativos de terminal, como REPLs, depuradores e apps TUI, por meio de um PTY.

Ver no GitHub
Estrelas
270
Forks
25
Issues abertas
2
Último commit
há 6 meses

O que é?

tui-use é uma ferramenta de linha de comando que permite a agentes de IA interagir com programas que esperam que uma pessoa use o teclado. Ela inicia um programa em um pseudo-terminal, renderiza a saída com um emulador xterm headless e disponibiliza a tela atual como texto simples e limpo. Assim, o agente pode enviar teclas, ler o resultado e decidir o que fazer em seguida.

A ferramenta atende a casos em que comandos de shell comuns não dão conta, como uma sessão de Python ou pdb com muito estado mantido na memória, uma sessão de depuração do GDB, um REPL do Node ou apps em tela cheia, como vim, lazygit, htop e fzf. Um daemon mantém as sessões PTY ativas entre chamadas separadas da CLI, para que o processo não precise ser reiniciado a cada etapa.

Em vez de aguardar e consultar repetidamente, o comando `wait` retorna quando a tela permanece estável durante um período de inatividade configurável ou quando um padrão de texto especificado aparece. Cada captura de tela também lista regiões destacadas com vídeo reverso, que indicam o item ativo do menu ou a aba selecionada. A instalação é feita via npm, e o projeto inclui pacotes de plugins para Claude Code e OpenAI Codex.

Recursos principais

  • 01Executa qualquer programa em um PTY e renderiza a saída com um emulador xterm headless.
  • 02Fornece capturas da tela em texto simples, opcionalmente no formato JSON.
  • 03Aguarda a estabilização da tela ou o aparecimento de um padrão de texto específico.
  • 04Informa trechos destacados com vídeo reverso para que os agentes identifiquem a seleção ativa.
  • 05Mantém as sessões ativas entre chamadas da CLI por meio de um daemon em segundo plano.
  • 06Oferece suporte a digitação, colagem, teclas especiais, rolagem e busca por regex na tela.

Casos de uso

  • Depurar uma sessão de Python de longa duração sem perder o estado mantido na memória.
  • Controlar breakpoints do GDB ou pdb e inspecionar variáveis a partir de um agente.
  • Permitir que um agente de programação com IA navegue por ferramentas em tela cheia, como vim ou lazygit.
  • Executar sessões interativas de REPL em que cada etapa depende da saída anterior.

Início rápido

  1. 1

    Instale a CLI pelo npm

    npm install -g tui-use
  2. 2

    Inicie um programa em uma sessão PTY

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

    Aguarde a tela estabilizar, digite uma resposta e pressione Enter

    tui-use wait
  4. 4

    Capture um snapshot da tela atual

    tui-use snapshot

Antes de usar

  • As cores e a maior parte da formatação do texto são removidas da saída da tela; apenas os destaques, o título e o estado de tela cheia são mantidos.
  • É necessário instalar a CLI separadamente antes que os plugins do Claude Code ou do Codex funcionem.

Tópicos

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

Perguntas frequentes

O que é tui-use?
Uma CLI que permite a agentes de IA controlar programas interativos de terminal, como REPLs, depuradores e apps TUI, por meio de um PTY. tui-use é uma ferramenta de linha de comando que permite a agentes de IA interagir com programas que esperam que uma pessoa use o teclado. Ela inicia um programa em um pseudo-terminal, renderiza a saída com um emulador xterm headless e disponibiliza a tela atual como texto simples e limpo. Assim, o agente pode enviar teclas, ler o resultado e decidir o que fazer em seguida.
tui-use é gratuito? Qual é a licença?
tui-use é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
tui-use ainda é mantido?
Sem commits há mais de 6 meses. O último commit de tui-use foi em 11 de abr. de 2026.
Para que posso usar tui-use?
Depurar uma sessão de Python de longa duração sem perder o estado mantido na memória. Controlar breakpoints do GDB ou pdb e inspecionar variáveis a partir de um agente. Permitir que um agente de programação com IA navegue por ferramentas em tela cheia, como vim ou lazygit. Executar sessões interativas de REPL em que cada etapa depende da saída anterior.
Como instalar tui-use?
Instale a CLI pelo npm: npm install -g tui-use Inicie um programa em uma sessão PTY: tui-use start python3 examples/ask.py Aguarde a tela estabilizar, digite uma resposta e pressione Enter: tui-use wait Capture um snapshot da tela atual: tui-use snapshot
Onde consigo tui-use?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/onesuper/tui-use

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados