Uso do Terminal

Este capítulo trata do terminal em si: entrada e saída, busca no terminal, copiar e colar, colagem de imagens, sugestões de comandos, os comandos v integrados, os comandos em segundo plano iniciados com vrun, a escolha do shell no Windows, a gravação de sessões, as configurações de renderizador e os atalhos.

1. Noções básicas

Uma sessão de terminal executa um shell real. No macOS e no Linux, é o shell padrão do sistema ($SHELL); no Windows, é o cmd por padrão, e isso pode ser alterado (consulte o §7). O diretório de trabalho é, por padrão, a raiz do projeto. O formulário de edição da sessão permite alterar o "Diretório de trabalho (vazio = raiz do projeto)" e definir um "Comando de inicialização (opcional)", que é executado toda vez que a sessão é iniciada (por exemplo, pnpm dev).

Quando vários agentes produzem muita saída ao mesmo tempo, o VelaTerm dá prioridade à sua digitação e à aba visível e limita a saída das abas em segundo plano. Esse comportamento é controlado por Configurações ▸ Avançado ▸ "Saída com prioridade em primeiro plano" (ativada por padrão). Se um programa em tela cheia parecer desconfigurado depois que você trocar de aba, clique no botão "Redesenhar" no cabeçalho do painel para redesenhá-lo. Configurações ▸ Avançado ▸ "Redesenhar ao trocar de aba" faz isso automaticamente sempre que uma aba fica visível.

2. Busca no terminal (⌘F)

⌘F abre uma barra de busca ("Buscar no terminal") no histórico de rolagem do terminal atual, com botões de anterior e próximo:

Para pesquisar em várias sessões e no histórico, use a busca global (⌘⇧F), descrita em Gerenciamento de Interface e Sessões.

3. Copiar e colar

• Selecione o texto com o mouse e use ⌘C / ⌘V ou o menu de contexto ("Copiar", "Colar", "Selecionar tudo", "Limpar", "Buscar…").
• Em programas que capturam o mouse (vim, htop e a maioria das interfaces de agente), mantenha Option pressionada no macOS, ou Shift no Windows e no Linux, enquanto arrasta para forçar uma seleção de texto normal.
• Interfaces de agente como Claude Code e Codex podem copiar texto por conta própria. Logo depois que elas fazem isso, se nada estiver selecionado no terminal, o menu de contexto mostra "N caracteres copiados · ⌘V para colar".

4. Colagem de imagens

Para entregar uma imagem a um agente de linha de comando, cole ou arraste a imagem para o terminal. Configurações ▸ Terminal ▸ "Colar imagem" oferece duas opções:

• Colar caminho do arquivo (padrão): a imagem é salva como arquivo temporário e o caminho dela é inserido no prompt, de modo que qualquer agente capaz de ler arquivos pode abri-la. O Codex a recebe como image_path: ….
• Colagem nativa: o Claude Code ou o Codex lê a imagem da área de transferência do sistema e mostra o próprio marcador de imagem. Essa opção só está disponível no aplicativo desktop local; as sessões remotas sempre colam um caminho de arquivo, para que o agente possa ler a imagem na própria máquina.

Configurações ▸ Comportamento ▸ "Limpar imagens coladas automaticamente" remove esses arquivos temporários quando o aplicativo é fechado e apaga, na inicialização, as sobras com mais de 24 horas. "Limpar agora" os remove imediatamente. As imagens inseridas em documentos nunca são afetadas.

5. Sugestões de comandos

Nas sessões de terminal comuns no macOS e no Linux, o VelaTerm pode mostrar uma lista de sugestões montada a partir das definições de preenchimento do seu próprio shell. Configurações ▸ Terminal ▸ "Sugestões de comandos" oferece "Automáticas" (padrão), "Com Tab" ou "Desativadas". Use as setas para selecionar uma opção e Tab para inseri-la; Enter sempre executa o comando como foi digitado. Quando a seleção não pode avançar mais, as setas para cima e para baixo voltam a atuar no shell; assim, a seta para cima na primeira opção recupera o comando anterior. A lista não está disponível no Windows. Todos os detalhes estão em Sugestões de Comandos.

6. Comandos integrados

Toda sessão iniciada pelo VelaTerm tem um conjunto de comandos curtos no PATH. Eles não precisam de instalação e funcionam tanto em terminais comuns quanto em sessões de agente:

Execute um comando com --help para ver as opções; Comandos de Sessão descreve cada um em detalhes. A maioria desses comandos também existe como habilidade no Claude Code (/vopen) e no Codex ($vopen); vrun e vflow não têm habilidade, e vask existe apenas como habilidade. As habilidades são instaladas pelo botão "Vela Skills" em Configurações ▸ Geral.

vopen escolhe a visualização conforme o tipo de arquivo:

vopen README.md          # Markdown → Markdown editor
vopen src/main.rs        # source code → code editor with syntax highlighting
vopen diagram.png        # image → image viewer
vopen https://crates.io  # web address → browser tab (desktop app only)

Caminhos relativos são resolvidos a partir do diretório atual, e vários arquivos podem ser abertos de uma vez. As abas de documento são descritas em Abas de Documento e Navegador; vspawn é descrito em Criação de Sessões e Colaboração no Git; vkb é descrito em Grafo de Código e Base de Conhecimento e Bases de Conhecimento Locais.

6.1 Comandos em segundo plano (vrun)

vrun <label> <command...> inicia um comando, aguarda a conclusão e depois exibe o código de saída, o tempo decorrido e o fim do log. Assim, um agente que inicia um build ou um teste demorado com vrun fica sabendo do resultado assim que ele estiver disponível. Fechar a sessão não interrompe o comando. vrun --status <label> informa o estado de um comando iniciado anteriormente, e -t <seconds> define o tempo de espera (1800 segundos por padrão); quando esse tempo se esgota, vrun sai com o código 124 e deixa o comando em execução.

Enquanto esses comandos são executados, uma linha "Comandos em segundo plano" aparece acima do terminal. Cada item mostra o rótulo e "Em execução (…)", um botão "Registro", que abre a saída do comando, e um botão "Parar"; clique em "Confirmar parada" para encerrar o comando. A linha desaparece quando não há nada em execução.

7. Escolha do shell (somente Windows)

No Windows, as sessões de terminal podem usar qualquer shell detectado: PowerShell, pwsh, cmd, Git Bash e todas as distribuições WSL instaladas. Escolha o shell no submenu "Novo terminal", em "Shell (vazio = padrão do sistema)" no formulário de edição da sessão ou no menu "Shell" do clique com o botão direito. Uma sessão em execução é reiniciada imediatamente com o novo shell. Configurações ▸ Terminal ▸ "Shell padrão" define o shell dos novos terminais que não têm uma escolha explícita.

As entradas do WSL aparecem como WSL: <distribution> somente quando o WSL informa uma distribuição instalada. Escolher uma delas inicia essa distribuição e mapeia para dentro dela o diretório do projeto no Windows. O WSL está disponível apenas para sessões de terminal comuns; as sessões de agente continuam usando o shell do host Windows. Os comandos v integrados não estão disponíveis em terminais WSL.

Sobre o Git Bash incluído: o instalador full inclui o Git Bash completo (com git, ssh e perl). O instalador min inclui um subconjunto essencial; quando você executa um comando ausente, ele oferece o download da versão completa, que também está disponível no item "Baixar Git Bash completo" do clique com o botão direito. As sessões de agente não são afetadas, pois usam o PowerShell.

O macOS e o Linux não têm seletor de shell; as sessões usam o shell padrão do sistema.

8. Gravação de sessões

Configurações ▸ Avançado ▸ "Gravar registros de sessão" vem desativada por padrão. Quando ela está ativada, o VelaTerm salva a saída de terminal das sessões de agente executadas na visão de terminal em um arquivo de log local, com até 50 MB por sessão. As sessões de terminal comuns nunca são gravadas.

Uma gravação permite reproduzir uma sessão arquivada como ela apareceu na tela e torna o texto dessa tela pesquisável. O VelaTerm só usa uma gravação quando o registro de conversa do próprio agente não pode ser lido; caso contrário, o registro de conversa é usado para visualização e busca. Os arquivos de gravação são excluídos junto com a sessão.

9. Renderizador

Configurações ▸ Avançado ▸ "Renderizador do terminal" oferece DOM (padrão) e WebGL. DOM é a opção recomendada no aplicativo desktop. Versões anteriores também ofereciam um renderizador Canvas; essa opção não existe mais, e uma preferência salva por Canvas agora usa DOM.

10. Atalhos comuns

A tabela lista os padrões do aplicativo desktop para macOS. Os aplicativos para Windows e Linux usam Ctrl+Alt em vez de ⌘ na maioria das ações (dividir abaixo é Ctrl+Alt+E, buscar em todas as sessões é Ctrl+Alt+G, e salvar continua sendo Ctrl+S). Os clientes de navegador usam padrões baseados em Ctrl que evitam os atalhos do próprio navegador. Configurações ▸ Atalhos mostra as combinações exatas no seu sistema, e todas as ações, exceto a troca de abas e o tamanho da fonte, podem ser alteradas ali.