Árvore de Arquivos

O nó de Árvore de Arquivos permite navegar pelos arquivos do seu projeto diretamente no canvas — sem precisar alternar para o Finder ou o seu IDE. É um gerenciador de arquivos completo embutido no seu espaço de trabalho.

Inserindo um nó de Árvore de Arquivos

Selecione a ferramenta Árvore de Arquivos na barra de ferramentas superior, depois clique e arraste no canvas para posicioná-la. A árvore abre no diretório de trabalho do seu espaço de trabalho por padrão.

Você pode ter múltiplas árvores de arquivos no mesmo canvas, e cada uma lembra independentemente o seu próprio estado — qual diretório está exibindo, quais pastas estão expandidas e qual modo de visualização está ativo.

Modos de visualização

Alterne entre quatro visualizações usando a barra de ferramentas no topo do nó:

• Visualização em lista — Um outline hierárquico, semelhante à visualização em lista do Finder do macOS. Suporta navegação para frente/trás e Recolher Tudo.
• Grade de ícones — Uma visualização baseada em miniaturas. Imagens, PDFs e vídeos exibem pré-visualizações do Quick Look em vez de ícones genéricos.
• Diff — Suas alterações não commitadas lado a lado com o original (veja Diff view com integração de agentes abaixo).
• Graph — O grafo de commits do repositório do workspace, com lanes de branch e as mesmas referências que você veria em uma ferramenta como git log --graph. Disponível quando o diretório da árvore está dentro de um repositório git.

Navegando pelos arquivos

Use a barra de ferramentas para mudar o diretório raiz dinamicamente. Clicar com o botão direito em um arquivo ou pasta abre um menu de contexto com opções para criar, renomear, mover e excluir.

Arrastando arquivos

Você pode arrastar arquivos da árvore diretamente para:

• Um terminal de agente — Compartilha o arquivo como contexto com o agente
• O canvas — Coloca como um nó de pré-visualização nativo (imagens, PDFs e vídeos são suportados)

Operações git

Quando seu workspace é um repositório git, a árvore de arquivos inclui um indicador de branch no topo. Clique nele para abrir um menu com operações git comuns:

• Commit — Preparar e commitar alterações
• Pull / Push — Sincronizar com o repositório remoto
• Checkout — Mudar para uma branch diferente
• New Branch — Criar uma nova branch a partir da atual
• Merge — Mesclar outra branch na atual
• Fetch — Buscar atualizações do remoto sem mesclar
• Stash — Guardar suas alterações não commitadas para depois

Essas operações rodam diretamente no Maestri — sem precisar alternar para um terminal ou cliente git externo para tarefas comuns.

Diff view com integração de agentes

A árvore de arquivos inclui uma visualização de diff que mostra suas alterações não commitadas. Além de revisar diffs, ela se integra diretamente com seus agentes — selecione qualquer bloco de código no diff e um ícone de chat aparecerá. Clique nele para abrir um popover onde você pode citar o bloco selecionado e pedir ao agente para explicar ou refinar.