Editor e visualizador

Quando um agente termina uma alteração, você quer lê-la e decidir se está correta — sem sair da central de comando para abrir o VS Code. O painel de editor/visualizador do TermTree é aberto ao lado do terminal para isso: não há uma árvore de arquivos, porque o terminal já cumpre essa função, nem LSP, preenchimento automático ou depurador, porque revisar o resultado produzido por um agente é uma tarefa diferente de escrever código do zero.

O terminal é o seu explorador de arquivos

O TermTree não tem uma árvore de arquivos. Em vez disso, o painel de editor/visualizador abre qualquer arquivo que você indicar em um terminal:

  • Use ⌘/Ctrl-clique em qualquer caminho de arquivo exibido na saída do terminal para abri-lo.
  • Caminhos escritos como hiperlinks OSC 8 (usados por algumas ferramentas e shells) podem ser clicados da mesma forma.
  • Clique com o botão direito em um caminho para Abrir arquivo / Abrir pasta — consulte Terminais.

Há um único painel global de editor/visualizador, compartilhado por todo o aplicativo — abrir um arquivo a partir de qualquer terminal o direciona para esse mesmo painel.

Edição e salvamento

Arquivos de texto são abertos em um editor CodeMirror com detecção de linguagem para realce de sintaxe. Edite normalmente e salve com Cmd+S / Ctrl+S. Um arquivo não salvo exibe um indicador de alterações ao lado do nome.

Apenas um arquivo pode ter alterações não salvas por vez. Se você tentar sair de um arquivo com alterações não salvas — mudando para outro arquivo ou fechando-o — o TermTree solicitará que você salve, descarte ou cancele antes de prosseguir.

Quando um arquivo é alterado no disco

Se o arquivo aberto for alterado no disco (por exemplo, se um agente editá-lo em um terminal) enquanto o seu buffer não tiver alterações, o TermTree o recarregará automaticamente — sem precisar de confirmação.

Se o seu buffer tiver alterações não salvas quando o arquivo for alterado no disco, o TermTree não substituirá as suas edições. Em vez disso, ele sinalizará o arquivo como “Alterado no disco — Recarregar”, para que você possa revisar a alteração externa e recarregar o arquivo deliberadamente depois de lidar com as suas próprias edições.

Painel de estrutura

Para arquivos Markdown, ative ou desative o painel Estrutura para ver uma árvore de títulos do arquivo atual. Clique em um título para ir até ele; recolha e expanda ramificações para navegar por documentos longos.

Alternar diff

Clique em Ver alterações para exibir um diff somente leitura do arquivo aberto em relação ao último commit (git HEAD) — uma maneira rápida de revisar o que um agente alterou antes de decidir o que manter. A opção de diff só aparece quando o arquivo realmente difere de HEAD. Arquivos muito grandes são excluídos, e um aviso de limite de tamanho é exibido no lugar do diff.

Visualização de PDFs e imagens

Arquivos .pdf e formatos comuns de imagem são abertos em um visualizador dedicado somente leitura, em vez do editor de texto.

O editor mantém um histórico de navegação conforme você abre arquivos. Vá para o arquivo anterior ou seguinte com Cmd+[ / Cmd+] (Ctrl+[ / Ctrl+], também disponíveis como Ctrl+Alt+Left / Ctrl+Alt+Right no menu nativo do Windows/Linux).

Arquivos recentes

Pressione Cmd+Shift+O / Ctrl+Shift+O para abrir a caixa de diálogo Arquivos recentes — uma lista sem duplicatas dos arquivos que você abriu, limitada a 15. A cada abertura, os arquivos que não existem mais no disco são removidos da lista, que persiste entre reinicializações.

Memória de visualização por arquivo

O TermTree lembra, para cada caminho de arquivo, qual modo de visualização você usou por último (Editor ou Pré-visualização) e a sua posição de rolagem em cada um — assim, ao retornar a um arquivo, você volta ao ponto onde parou. Por padrão, arquivos Markdown usam a Pré-visualização; todos os outros tipos de arquivo usam o Editor. Essa memória é limitada a 50 arquivos e dura apenas durante a sessão atual — ela é apagada ao reiniciar. Consulte Persistência da sessão para saber o que permanece ou não após uma reinicialização.

Para conhecer os comportamentos de pré-visualização específicos de Markdown e HTML — imagens locais, links entre arquivos, diagramas Mermaid, renderização dinâmica de HTML e exportação — consulte Pré-visualização e exportação.