Reconhecimento de agentes

Ao executar vários agentes ao mesmo tempo, você não consegue acompanhar todos os terminais — cada nó precisa informar quando precisa de você e onde está trabalhando, para que você possa agir em vez de ficar supervisionando. O TermTree faz isso reconhecendo CLIs de agentes em execução em um terminal: atualmente, ele funciona com o Claude Code e também detecta o Codex, embora o terminal de um nó não precise executar agente algum — ele é apenas um shell comum que o TermTree também consegue reconhecer quando está executando um agente.

Indicador de worktree

Um agente que entra em um git worktree altera seu próprio diretório de trabalho para esse local e, a partir daí, informa caminhos — em sua saída, em um stack trace, no git status — relativos à raiz desse worktree, e não ao diretório do shell do painel. Se você perder de vista em qual worktree um agente está, poderá acabar revisando a cópia errada de um arquivo; por isso, o TermTree exibe essa informação automaticamente.

Quando o TermTree detecta que o agente em primeiro plano de um terminal está trabalhando dentro de um git worktree, ele exibe um ícone de worktree nesse nó e na barra de título do terminal. Passe o cursor sobre o ícone para ver o nome da branch do worktree.

O indicador persiste após reinicializações — reabra o TermTree e um nó cujo agente estava em um worktree continuará exibindo o indicador.

Não disponível no Windows nativo. A detecção de worktrees depende da resolução de caminhos no estilo POSIX, portanto não funciona em um shell nativo do Windows. Ela também não está disponível através de uma fronteira do WSL, que oculta do host o diretório de trabalho do agente — nesse caso, o TermTree usa como alternativa o diretório informado pelo shell.

Retomando uma sessão do Claude

Pressione Cmd+Shift+R / Ctrl+Shift+R com um nó selecionado para retomar sua sessão do Claude Code (claude --resume) — útil se o terminal tiver sido fechado ou se você quiser voltar a uma conversa sem digitar novamente o comando de retomada. Consulte Persistência de sessões para saber como isso também acontece automaticamente após reinicializações do aplicativo.

Como o TermTree sabe que um agente está aguardando você

O status INPUT (ponto laranja) significa que um agente está bloqueado, aguardando sua resposta. O TermTree detecta isso de duas maneiras:

  • Claude Code — detecção definitiva. O TermTree registra um hook de Notification em ~/.claude/settings.json e injeta um TERMTREE_NODE_ID no ambiente de cada terminal. Quando o Claude dispara uma notificação (por exemplo, para solicitar permissão para uma chamada de ferramenta), o TermTree sabe com certeza qual nó precisa da sua atenção — ele não está fazendo uma suposição com base no texto do terminal.
  • Outras CLIs — alternativa baseada em correspondência de padrões. Para agentes sem integração por hook, o TermTree examina a saída do terminal em busca de padrões comuns de prompts bloqueantes (como confirmações no estilo [y/N]) para inferir que o terminal está aguardando uma entrada.