Arquivos e editor

A seção Arquivos, na barra lateral, mostra as pastas e os arquivos do projeto aberto. Clique num arquivo de texto e ele abre num editor em abas, o mesmo motor de edição do VS Code (Monaco), sem sair do TowerCTL. Dá para achar, criar, renomear e excluir arquivos e ajustar um texto sem pedir ao agente.

Onde ficam os arquivos#

Na barra lateral, o projeto aberto tem a seção Arquivos logo abaixo do nome. Clique no título dela para esconder ou mostrar a árvore; o app lembra a sua escolha. O botão Arquivos, na barra do topo, abre a seção (se estiver fechada) e leva o cursor para o campo de busca.

A seção mostra a pasta do projeto, que é onde os agentes trabalham. Quando o último painel em que você clicou é de um ajudante que trabalha numa cópia própria do projeto (um worktree), ela mostra a cópia dele, com o aviso Pasta do ajudante …. Clique em outro painel e a lista volta para a pasta daquele painel.

As pastas .git, node_modules e .towerctl não aparecem na lista nem na busca.

Navegar e buscar#

Clique numa pasta para abrir ou fechar. O app lembra quais pastas você deixou abertas em cada projeto. Pastas com muitos arquivos mostram os primeiros e um botão Mostrar mais, com a quantidade que falta.
A lista se atualiza sozinha quando os agentes (ou você, pelo Explorer, ou pelo Finder no Mac) criam, mudam ou apagam arquivos. Se isso parar de funcionar, aparece “A lista parou de se atualizar sozinha.” com o botão Atualizar.
No campo Buscar arquivo…, escreva um pedaço do nome. A lista passa a mostrar só os arquivos e pastas que combinam, com a pasta de cada um ao lado. A busca mostra até 200 resultados; se houver mais, o aviso pede para escrever mais do nome. Esc limpa a busca.
Sem resultado, aparece “Nada encontrado.”. Uma pasta sem nada dentro mostra “Pasta vazia.”.

Abrir um arquivo#

Há duas maneiras de abrir, como no VS Code:

Um clique: Abre o arquivo numa aba de visualização, com o nome em itálico. Clicar em outro arquivo troca o conteúdo dessa mesma aba, para você olhar vários arquivos sem encher a barra de abas.
Dois cliques: Abre e mantém a aba, e o cursor já vai para o editor. Dois cliques na aba de visualização também a mantêm. Se você começar a digitar numa aba de visualização, ela passa a ser mantida sozinha.

As abas ficam por projeto: ao trocar de projeto, você vê as abas daquele projeto. O arquivo aberto aparece destacado na árvore.

As abas e os terminais#

Quando há ao menos um arquivo aberto, aparece uma barra de abas no alto da área principal. A primeira aba é sempre Terminais, com o número de painéis da missão: um clique nela volta para os agentes, que continuam trabalhando enquanto você edita. As abas seguintes são os arquivos.

Lado a lado: o botão ◫, no fim da barra de abas, mostra o editor e os terminais juntos. Clique de novo para ficar só com o editor.
Voltar aos terminais: se você está só com o editor e clica num painel (ou usa Ctrl+1 a Ctrl+9 (⌘1 a ⌘9 no Mac) ou abre um painel novo), o app mostra os terminais.
Fechar uma aba: o ✕ da aba, o clique com o botão do meio do mouse ou Ctrl+W (⌘W no Mac) com o cursor no editor.
Botão direito numa aba: Fechar, Fechar as outras (as que têm mudança não salva ficam abertas), Abrir no VS Code, Mostrar no Explorer (no Mac, Mostrar no Finder; no Linux, Mostrar na pasta) e Copiar caminho.
Arquivos de um ajudante: a aba ganha o nome do ajudante ao lado do nome do arquivo, para você não confundir com o arquivo de mesmo nome do projeto.

Editar e salvar#

O editor mostra números de linha, cores para as linguagens comuns (HTML, CSS, JavaScript e TypeScript, JSON, Markdown e outras) e um minimapa. Ele usa a mesma fonte e o mesmo tamanho dos terminais, e o mesmo tema. Acima do texto, uma barra mostra o caminho do arquivo e os botões Abrir no VS Code e Salvar.

Salvar: aperte Ctrl+S (⌘S no Mac) ou clique em Salvar. O botão só fica ativo quando há mudança.
Mudanças não salvas: a aba ganha um ponto (●).
Atalhos do app: dentro do editor eles ficam desligados, para todas as teclas serem do editor (por exemplo, Ctrl+/ comenta uma linha, ⌘/ no Mac). Para voltar a usá-los, clique num terminal ou na barra do topo.

Fechar com mudanças não salvas#

Ao fechar uma aba com mudança não salva, o app pergunta Salvar as mudanças em …?, com três botões:

Salvar: Grava o arquivo e fecha a aba.
Não salvar: Fecha a aba e descarta o que você mudou.
Cancelar: Não fecha nada. Esc faz o mesmo.

Fechar o app com arquivos não salvos#

Se você fechar o TowerCTL (ou instalar uma atualização) com algum arquivo não salvo, o app pergunta antes, para você não perder o trabalho.

Quando o arquivo muda no disco#

Os agentes mexem nos mesmos arquivos que você. O editor percebe quando o arquivo muda no disco:

Você não editou nada: o editor recarrega sozinho.
Você já editou: o editor não joga fora o seu trabalho. Aparece a faixa O arquivo mudou no disco. com dois botões:
- Recarregar: descarta o que você escreveu e abre a versão do disco.
- Manter o meu: mantém o seu texto, e o próximo Salvar substitui a versão do disco.
Se o arquivo for apagado enquanto está aberto, a faixa diz “O arquivo foi apagado no disco. Salvar cria de novo.”.

Arquivos que o editor não abre#

Arquivo grande demais: o editor abre arquivos de texto de até 1 MB. Nos maiores, a aba mostra o tamanho e os botões Abrir no VS Code e Mostrar no Explorer (Mostrar no Finder no Mac, Mostrar na pasta no Linux).
Arquivo binário: imagens, fontes e programas não são texto e têm os mesmos dois botões.
Texto que não é UTF-8: abre só para leitura, com o aviso “Este arquivo não está em UTF-8. Ele abre só para leitura.”, para o app não estragar os acentos.

Abrir no VS Code#

O editor do TowerCTL é ótimo para ajustes rápidos, mas não carrega as extensões do VS Code (formatadores, corretores, temas de ícones). Quando você precisa delas, clique em Abrir no VS Code, na barra do editor, no menu da aba ou no menu do arquivo na árvore. O arquivo abre no VS Code com as suas extensões.

Se o VS Code não estiver instalado, o app avisa “VS Code não encontrado” e abre o arquivo no programa padrão do sistema. No Windows, um arquivo que ele executaria (um script, por exemplo) abre no Bloco de Notas, para nada rodar sem querer. No Mac e no Linux, esses arquivos não são abertos: o app mostra o arquivo no Finder ou no gerenciador de arquivos.

Clique com o botão direito num arquivo ou numa pasta, ou clique no ⋯ da linha, para abrir o menu:

Abrir: Só para arquivos. Abre e mantém a aba, como dois cliques.
Abrir no VS Code: Abre o arquivo ou a pasta no VS Code.
Mostrar no Explorer: Abre o Explorador de Arquivos do Windows com o item selecionado. No Mac, o item se chama Mostrar no Finder, e no Linux, Mostrar na pasta.
Copiar caminho: Copia o caminho completo, pronto para colar num painel ou numa conversa com o agente. O app confirma “Caminho copiado: …”.
Novo arquivo: Cria um arquivo vazio dentro da pasta (ou ao lado do arquivo) selecionada.
Nova pasta: Cria uma pasta no mesmo lugar.
Renomear: Troca o nome do item.
Excluir: Manda o item para a Lixeira do Windows (ou do Linux) ou para o Lixo do Mac.

No alto da seção há os botões + (Novo arquivo), ⊞ (Nova pasta) e ⋯ (as ações da pasta de cima). O menu também abre com o botão direito num espaço vazio da lista.

Criar e renomear#

Clique em + ou ⊞, ou use o menu de um item. O item novo vai para a pasta selecionada, ou para a pasta do arquivo selecionado, ou para a raiz se nada estiver selecionado.
Escreva o nome no campo que aparece (Nome do arquivo ou Nome da pasta) e aperte Enter. Esc cancela.
Um arquivo novo já abre no editor. O app confirma, por exemplo, “Arquivo pagina.html criado.”.

Para renomear, escolha Renomear no menu ou aperte F2 com o item selecionado. Se o arquivo estiver aberto no editor, a aba continua aberta com o novo nome.

O app recusa nomes que o sistema não aceita (por exemplo, no Windows, com < > : " / \ | ? *, ou terminando em ponto ou espaço) e nomes que já existem na mesma pasta, e diz o motivo logo abaixo dos botões.

Excluir#

Escolha Excluir no menu ou aperte Delete com o item selecionado. O app pergunta “Mandar … para a Lixeira?”. Ao confirmar, o item vai para a Lixeira (no Mac, a pergunta é “Mandar … para o Lixo?” e o item vai para o Lixo), e não some de vez: dá para restaurar por lá. Se for uma pasta, vai tudo o que está dentro dela. Uma aba aberta com esse arquivo é fechada; se ela tinha mudança não salva, fica aberta com o aviso de que o arquivo foi apagado.