Uso do Terminal

Este capítulo aborda o terminal em si: entrada/saída, busca dentro do terminal, copiar/colar e imagens, o comando vopen, seleção de shell em Windows e gravação de sessões.

1. Noções básicas

Uma sessão de terminal é um shell real (o shell padrão do sistema em macOS / Linux; cmd por padrão em Windows, com possibilidade de alteração — veja §5). O diretório de trabalho é definido como a raiz do projeto por padrão e pode ser alterado na tela de edição da sessão, que também oferece um “Comando de inicialização” — executado automaticamente toda vez que a sessão é iniciada (por exemplo, pnpm dev).

A latência ao digitar é projetada especificamente: quando vários elementos aparecem na tela, a entrada recebe prioridade e as abas em segundo plano são limitadas, para que o conteúdo em primeiro plano nunca fique para trás em relação às suas teclas pressionadas. Se uma interface TUI parecer com defeito após a troca de aba, o botão de redesenho no cabeçalho da janela força uma nova pintura completa.

2. Busca dentro do terminal (⌘F)

Busque no histórico de rolagem do terminal atual, com navegação anterior/próxima:

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

3. Copiar e colar

• Selecione o conteúdo para destacá-lo; o menu de contexto oferece opções de copiar/colar, e os atalhos habituais ⌘C / ⌘V funcionam normalmente.
• Em programas TUI que capturam o mouse (vim, htop), mantenha a tecla Option/Alt pressionada enquanto arrasta para forçar a seleção normal de texto.

Colar imagem é o canal usado para enviar imagens aos agentes: cole ou arraste uma captura de tela/arquivo de imagem para o terminal, e VelaTerm grava a imagem em uma localização temporária e insere o caminho do arquivo em **** no terminal — exatamente como os CLIs como o Claude esperam. Configurações relacionadas: “Colar imagem” permite escolher entre “Carregar como arquivo” (sempre gerando um caminho concreto) e “Padrão do agente”; “Limpar automaticamente imagens coladas” remove periodicamente essas imagens temporárias, com um botão “Limpar agora”.

4. vopen: abrir arquivos e páginas a partir do terminal

Cada sessão possui PATH com três comandos pequenos (instalação zero): vopen, vspawn, vspawn-tree. Observe que esses são os comandos do terminal — as habilidades / com nomes iguais, usadas dentro das conversas do Claude, são algo separado e exigem a opção Vela Skills em Configurações ▸ Geral. vopen envia conteúdos para a área central:

vopen README.md          # markdown → WYSIWYG editor
vopen src/main.rs        # source code → syntax-highlighted editor
vopen diagram.png        # image → built-in image viewer
vopen https://crates.io  # URL → built-in browser tab (desktop only)

Abas de documento completas (edição em modo duplo, localizar e substituir, PDF exportar): Abas de Documento e Navegador. Criação com vspawn: Criação de Sessão e Colaboração via Git.

5. Seleção de shell (apenas Windows)

Em Windows, as sessões do terminal podem escolher explicitamente um shell — PowerShell / pwsh / cmd / Git Bash — por meio do submenu “Novo”, do menu suspenso no formulário de edição da sessão ou com clique direito em “Shell ▸”; uma sessão em execução aplica a alteração na reinicialização. Configurações ▸ Terminal ▸ “Shell padrão” define o padrão para novas sessões.

Sobre o Git Bash incluído: o instalador completo fornece a versão total (com git, ssh e perl); o instalador mínimo fornece um subconjunto essencial, e comandos ausentes solicitam o download sob demanda da versão completa (também disponível por clique direito em “Baixar Git Bash completo”). As sessões de agente não são afetadas — elas sempre usam PowerShell.

macOS / Linux não possuem seleção de shell; as sessões usam o shell padrão do sistema ($SHELL).

6. Gravação de sessões

Configurações ▸ Avançado ▸ “Gravar logs de sessão” (desativado por padrão). Quando ativado, o conteúdo do terminal é gravado em um arquivo local a partir do início da sessão (limite de 50MB por sessão). Isso oferece dois benefícios:

• As sessões arquivadas permitem reproduzir o terminal exatamente como estava;
• A busca global pode encontrar saídas do terminal puro (as conversas de agente não precisam ser gravadas — elas possuem transcrições).

Os arquivos de gravação são removidos quando a sessão é excluída.

7. Atalhos comuns

macOS valores padrão abaixo; em Windows / Linux, substitua ⌘ por Ctrl+Alt (com algumas exceções — consulte a página de Configurações). Tudo, exceto ⌘1–9 e o trio de tamanhos de fonte, pode ser reatribuído em Configurações ▸ Atalhos.